Skip to main content

对 GitHub Codespaces 的个性化选项进行故障排除

有关点文件和设置同步的常见问题的故障排除步骤。

你可以通过使用 GitHub Enterprise Cloud 上的 dotfiles 存储库或使用“设置同步”来个性化 GitHub Codespaces。有关详细信息,请参阅“个性化你帐户的 GitHub Codespaces”。

对点文件故障排除

如果代码空间无法从 dotfiles 中选取配置设置,则应执行以下调试步骤。

  1. 通过在个人 GitHub Codespaces 设置中选择“自动安装点文件”来启用点文件。

    codespace 设置的“点文件”部分的屏幕截图,其中清除了“自动安装点文件”选项。

  2. 检查 /workspaces/.codespaces/.persistedshare/dotfiles 以查看点文件是否被克隆。

    • 如果您的 dotfiles 被克隆,请尝试手动重新运行安装脚本以验证其可执行性。
    • 如果点文件未被克隆,请检查 /workspaces/.codespaces/.persistedshare/EnvironmentLog.txt 是否存在克隆问题。
  3. 检查 /workspaces/.codespaces/.persistedshare/creation.log 以了解可能出现的问题。 有关详细信息,请参阅创建日志

如果已正确选取点文件中的配置,但部分配置与 codespace 不兼容,请使用 $CODESPACES 环境变量为特定于 codespace 的配置设置添加条件逻辑。 有关可能与 codespace 不兼容的配置的详细信息,请参阅:

对设置同步进行故障排除

可以关闭设置同步以停止与 VS Code 的实例之间的设置同步。

当你关闭 codespace 中的设置同步时,新 codespace 将继续使用上次将设置推送到云时缓存的设置。 如果对 codespace 使用 VS Code Web 客户端,并且希望 codespace 使用默认设置而不是缓存的设置,则可以禁用设置同步。有关详细信息,请参阅“管理设置同步的首选项”。

如果要在 VS Code 的所有实例(包括桌面应用程序)中恢复使用默认的 VS Code 设置,可以在关闭“设置同步”时清除云中的缓存。

  1. 如果设置同步当前在 VS Code 实例中处于关闭状态,并且你想要清除缓存的设置,则必须首先将其打开。 有关说明,请参阅“个性化你帐户的 GitHub Codespaces”。

  2. 在活动栏底部,选择 ,然后单击“设置同步已打开”。

  3. 在下拉列表中,单击“设置同步: 关闭”。

    下拉菜单的屏幕截图,其中“设置同步: 关闭”选项以深橙色轮廓突出显示。

  4. 若要清除缓存的设置,请在对话框中选择“关闭所有设备上的同步并清除云中的数据”。

    “是否要关闭同步?”的屏幕截图 对话框,其中包含用于从所选云中清除数据的选项。

  5. 单击“关闭”。