跳至主要内容

解决 GitHub Codespaces 个性化选项的故障

解决 dotfiles 和设置同步常见问题的故障步骤。

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

解决 dotfiles 故障

如果你的 Codespace 无法从 dotfiles 获取配置设置,你应按照以下调试步骤进行操作。

  1. 你的个人 GitHub Codespaces 设置 中选择自动安装 dotfiles 来启用 dotfiles。

    Screenshot of the "Dotfiles" section of the codespace settings, with the "Automatically install dotfiles" option cleared.

  2. 检查 /workspaces/.codespaces/.persistedshare/dotfiles 以查看你的 dotfiles 是否已克隆。

    • 如果你的 dotfiles 已克隆,请尝试手动重新运行你的安装脚本以验证它是否可执行。
    • 如果你的 dotfiles 未克隆,请检查 /workspaces/.codespaces/.persistedshare/EnvironmentLog.txt 以查看是否在克隆过程中出现问题。
  3. 检查 /workspaces/.codespaces/.persistedshare/creation.log 以查找可能出现的问题。有关更多信息,请参阅 创建日志

如果已正确提取 dotfiles 中的配置,但部分配置与 Codespaces 不兼容,请使用 $CODESPACES 环境变量为特定于 Codespace 的配置设置添加条件逻辑。有关可能与 Codespaces 不兼容的配置的更多信息,请参阅

设置同步疑难解答

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

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

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

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

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

  3. 在下拉菜单中,单击设置同步:关闭

    Screenshot of the dropdown menu with the "Settings Sync: Turn Off" option highlighted with a dark orange outline.

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

    Screenshot of the "Do you want to turn off sync?" dialog, with the option to clear data from the cloud selected.

  5. 单击关闭