# GitHub Codespaces 的个性化设置选项疑难解答

有关Dotfiles和Settings Sync常见问题的故障排除步骤。

你可以通过使用 GitHub Codespaces 上的 `dotfiles` 仓库或使用“Settings Sync”来个性化设置 GitHub。有关详细信息，请参阅“[个性化你帐户的 GitHub Codespaces](/zh/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account)”。

## 对点文件故障排除

如果 Codespace 无法从 dotfiles 中选取配置设置，则应执行以下调试步骤。

1. 通过在**个人 GitHub Codespaces 设置**中选择“[自动安装点文件](https://github.com/settings/codespaces)”来启用点文件。

   ![Codespace 设置中的“Dotfiles”部分的屏幕截图，其中清除了“自动安装 Dotfiles”选项。](/assets/images/help/codespaces/install-custom-dotfiles.png)

2. 检查 `/workspaces/.codespaces/.persistedshare/dotfiles` 来确认 dotfiles 是否被克隆。
   * 如果您的 dotfiles 被克隆，请尝试手动重新运行安装脚本以验证其可执行性。
   * 如果点文件未被克隆，请检查 `/workspaces/.codespaces/.persistedshare/EnvironmentLog.txt` 是否存在克隆问题。

3. 检查 `/workspaces/.codespaces/.persistedshare/creation.log` 以了解可能出现的问题。 有关详细信息，请参阅[创建日志](/zh/codespaces/troubleshooting/github-codespaces-logs#creation-logs)。

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

* [排查存储库身份验证问题](/zh/codespaces/troubleshooting/troubleshooting-authentication-to-a-repository#problems-with-the-repository-from-which-you-created-the-codespace)
* [排查 GitHub Codespaces 的 GPG 验证问题](/zh/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces#errors-caused-by-conflicting-configuration)

## 对设置同步进行故障排除

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

当你关闭 codespace 中的设置同步时，新 codespace 将继续使用上次将设置推送到云时缓存的设置。 如果对 codespace 使用 VS Code Web 客户端，并且希望 codespace 使用默认设置而不是缓存的设置，则可以禁用设置同步。有关详细信息，请参阅[管理“设置同步”的首选项](/zh/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account#managing-your-preferences-for-settings-sync)。

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

1. 如果设置同步当前在 VS Code 实例中处于关闭状态，并且你想要清除缓存的设置，则必须首先将其打开。 有关说明，请参阅“[个性化你帐户的 GitHub Codespaces](/zh/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account#turning-on-settings-sync-in-a-codespace)”。

2. 在活动栏底部，选择 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="The gear icon" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg>，然后单击“设置同步已打开”。

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

   ![下拉菜单的屏幕截图，其中“设置同步: 关闭”选项以深橙色轮廓突出显示。](/assets/images/help/codespaces/settings-sync-turn-off.png)

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

   ![“是否要关闭同步?”的屏幕截图 对话框，其中包含用于从所选云中清除数据的选项。](/assets/images/help/codespaces/turn-off-sync-dialog.png)

5. 单击“关闭”。