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 的配置设置添加条件逻辑。

对设置同步进行故障排除

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

默认情况下,禁用设置同步时,新 codespace 将继续使用上次将设置推送到云时缓存的设置。 如果仍在使用缓存的设置创建 codespace,而你想要恢复使用 codespace 中的默认 VS Code 设置,则可以在禁用设置同步的同时清除云中的缓存。

  1. 如果当前在 VS Code 的实例中禁用了设置同步,必须先启用它。 有关说明,请参阅“个性化你帐户的 GitHub Codespaces”。

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

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

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

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

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

  5. 单击“关闭”。