{"meta":{"title":"对 GitHub Codespaces 客户端进行故障排除","intro":"本文提供有关在使用用于 GitHub Codespaces 的客户端时可能遇到的问题的故障排除信息。","product":"Codespaces","breadcrumbs":[{"href":"/zh/codespaces","title":"Codespaces"},{"href":"/zh/codespaces/troubleshooting","title":"故障排除"},{"href":"/zh/codespaces/troubleshooting/troubleshooting-github-codespaces-clients","title":"Codespaces 客户端"}],"documentType":"article"},"body":"# 对 GitHub Codespaces 客户端进行故障排除\n\n本文提供有关在使用用于 GitHub Codespaces 的客户端时可能遇到的问题的故障排除信息。\n\n
\n\n## Visual Studio Code Web 客户端故障排除\n\n如果在非基于 Chromium 的浏览器中使用 GitHub Codespaces 时遇到问题，请尝试切换到基于 Chromium 的浏览器，例如 Google Chrome 或 Microsoft Edge。 或者，在 [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen) 存储库中通过搜索标记有浏览器名称（如 [`firefox`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+label%3Afirefox) 或 [`safari`](https://github.com/Microsoft/vscode/issues?q=is%3Aopen+is%3Aissue+label%3Asafari)）的问题来检查浏览器是否存在已知问题。\n\n如果在基于 Chromium 的浏览器中使用 GitHub Codespaces 时遇到问题，可在 [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen) 存储库中检查是否遇到 VS Code 的另一个已知问题。\n\n### 与在本地使用 VS Code 的差异\n\n在浏览器中使用 VS Code Web 客户端打开 codespace 时，你会注意到与在 VS Code 桌面应用程序的本地工作区中工作有一些差异。 例如，某些键绑定将不同或丢失，并且某些扩展的行为可能不同。 有关摘要，请参阅 VS Code 文档中的[已知限制和调整](https://code.visualstudio.com/docs/remote/codespaces#_known-limitations-and-adaptations)。\n\n可使用 [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) 存储库中的 VS Code 体验检查已知问题并记录新问题。\n\n### Visual Studio Code Insiders\n\nVisual Studio Code Insiders 是 VS Code 中最常见的版本。 它具有所有最新功能和错误修复，但偶尔也可能包含导致构建中断的新问题。\n\n如果你使用的是 Insiders 版本并发现损坏的行为，我们建议切换到 Visual Studio Code Stable 版，然后重试。\n\n单击编辑器左下方的“”，然后选择“切换到稳定版本…”。如果 VS Code Web 客户端未加载或“”不可用，可将 \\*\\*\\*\\* 追加到 codespace URL 并在该 URL 处加载 codespace 来强制切换到 Visual Studio Code 稳定版。\n\n如果在 Visual Studio Code 稳定版中未修复此问题，请检查已知问题，如果需要，请在 [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) 存储库中记录 VS Code 体验的新问题。\n\n### Simple Browser 疑难解答\n\n在 codespace 中启动 Web 应用程序后，可以在被嵌入到 VS Code 的 Simple Browser 中预览正在运行的应用程序。 在某些项目中，应用程序启动时，应用程序会自动在编辑器的 Simple Browser 选项卡中打开。 如果在 codespace 的 `devcontainer.json` 配置文件中，运行应用程序的端口的 `onAutoForward` 属性设置为 `openPreview`，则会发生这种情况。\n\n```json\n\"portsAttributes\": {\n \"3000\": {\n \"label\": \"Application\",\n \"onAutoForward\": \"openPreview\"\n }\n}\n```\n\n如果 Simple Browser 选项卡未自动打开，则可以手动打开 Simple Browser 以查看应用程序。\n\n1. 在 VS Code 中，单击“端口”选项卡。\n2. 右键单击端口，然后单击“在编辑器中预览”。\n\n ![VS Code“端口”选项卡中弹出菜单的屏幕截图。菜单项“在编辑器中预览”以深橙色边框突出显示。](/assets/images/help/codespaces/preview-in-editor-vscode.png)\n\n#### “Simple Browser”选项卡不会自动打开\n\n如果 `devcontainer.json` 配置文件为端口指定了 `\"onAutoForward\": \"openPreview\"`，但 Simple Browser 在应用程序启动时未自动打开，请检查应用程序是否已在配置中指定的端口上启动。 如果预期端口正忙，应用程序可能会在其他端口上启动。\n\n为实现 `devcontainer.json` 中指定的端口配置，GitHub Codespaces 会在创建 codespace 时将配置写入 VS Code 的 `settings.json` 文件。 可以在 codespace 中检查配置是否已正确写入 `settings.json`。\n\n1. 在 codespace 的终端中，输入以下命令。\n\n ```bash copy\n cat ~/.vscode-remote/data/Machine/settings.json\n ```\n\n2. 验证文件 `settings.json` 是否包含如下所示的行。\n\n ```json\n \"remote.portsAttributes\": {\n \"3000\": {\n \"label\": \"Application\",\n \"onAutoForward\": \"openPreview\"\n }\n }\n ```\n\n如果 `settings.json` 文件不包含这些设置，请检查是否已启用点文件，以及点文件中的任何配置是否覆盖 `settings.json` 文件。 有关详细信息，请参阅“[个性化你帐户的 GitHub Codespaces](/zh/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account#dotfiles)”。\n\n#### 应用程序未加载\n\n有时，你可能会发现“Simple Browser”选项卡处于打开状态，但显示错误页图标或空白页，而不是正在运行的应用程序。 如果要加载的 Web 应用程序包含限制可能嵌入网站页面的域的内容安全策略 (CSP)，则可能会发生这种情况。 有关详细信息，请参阅 MDN 网站上的 [CSP： frame-ancestors](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/frame-ancestors)。\n\n可以在本地更改应用程序的 `frame-ancestors` 安全策略，使应用程序显示在 Simple Browser 中。 或者，如果某个 `frame-ancestors` 策略导致该问题，则应能够通过在常规浏览器选项卡中而不是在 Simple Browser 中打开应用程序来查看该应用程序。 若要实现该操作，请单击 VS Code 中的“端口”选项卡，右键单击该端口，然后单击“在浏览器中打开” 。\n\n
\n\n
\n\n## VS Code 故障排除\n\n在 VS Code 桌面应用程序中打开 codespace 时，你可能会注意到与在本地工作区中工作相比存在一些差异，但体验应该相似。\n\n如果遇到问题，可使用 [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) 存储库中的 VS Code 体验检查已知问题并记录新问题。\n\n### Visual Studio Code Insiders\n\nVisual Studio Code Insiders 是 VS Code 中最常见的版本。 它具有所有最新功能和错误修复，但偶尔也可能包含导致构建中断的新问题。\n\n如果你使用的是 Insiders 版本并发现损坏的行为，我们建议切换到 Visual Studio Code Stable 版，然后重试。\n\n若要切换到 Visual Studio Code 稳定版，请关闭 Visual Studio Code Insiders 应用程序，打开 Visual Studio Code 稳定版应用程序，然后重新打开 codespace。\n\n如果在 Visual Studio Code 稳定版中未修复此问题，请检查已知问题，如果需要，请在 [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces) 存储库中记录 VS Code 体验的新问题。\n\n### Simple Browser 疑难解答\n\n在 codespace 中启动 Web 应用程序后，可以在被嵌入到 VS Code 的 Simple Browser 中预览正在运行的应用程序。 在某些项目中，应用程序启动时，应用程序会自动在编辑器的 Simple Browser 选项卡中打开。 如果在 codespace 的 `devcontainer.json` 配置文件中，运行应用程序的端口的 `onAutoForward` 属性设置为 `openPreview`，则会发生这种情况。\n\n```json\n\"portsAttributes\": {\n \"3000\": {\n \"label\": \"Application\",\n \"onAutoForward\": \"openPreview\"\n }\n}\n```\n\n如果 Simple Browser 选项卡未自动打开，则可以手动打开 Simple Browser 以查看应用程序。\n\n1. 在 VS Code 中，单击“端口”选项卡。\n2. 右键单击端口，然后单击“在编辑器中预览”。\n\n ![VS Code“端口”选项卡中弹出菜单的屏幕截图。菜单项“在编辑器中预览”以深橙色边框突出显示。](/assets/images/help/codespaces/preview-in-editor-vscode.png)\n\n#### “Simple Browser”选项卡不会自动打开\n\n如果 `devcontainer.json` 配置文件为端口指定了 `\"onAutoForward\": \"openPreview\"`，但 Simple Browser 在应用程序启动时未自动打开，请检查应用程序是否已在配置中指定的端口上启动。 如果预期端口正忙，应用程序可能会在其他端口上启动。\n\n为实现 `devcontainer.json` 中指定的端口配置，GitHub Codespaces 会在创建 codespace 时将配置写入 VS Code 的 `settings.json` 文件。 可以在 codespace 中检查配置是否已正确写入 `settings.json`。\n\n1. 在 codespace 的终端中，输入以下命令。\n\n ```bash copy\n cat ~/.vscode-remote/data/Machine/settings.json\n ```\n\n2. 验证文件 `settings.json` 是否包含如下所示的行。\n\n ```json\n \"remote.portsAttributes\": {\n \"3000\": {\n \"label\": \"Application\",\n \"onAutoForward\": \"openPreview\"\n }\n }\n ```\n\n如果 `settings.json` 文件不包含这些设置，请检查是否已启用点文件，以及点文件中的任何配置是否覆盖 `settings.json` 文件。 有关详细信息，请参阅“[个性化你帐户的 GitHub Codespaces](/zh/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account#dotfiles)”。\n\n#### 应用程序未加载\n\n有时，你可能会发现“Simple Browser”选项卡处于打开状态，但显示错误页图标或空白页，而不是正在运行的应用程序。 如果要加载的 Web 应用程序包含限制可能嵌入网站页面的域的内容安全策略 (CSP)，则可能会发生这种情况。 有关详细信息，请参阅 MDN 网站上的 [CSP： frame-ancestors](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/frame-ancestors)。\n\n可以在本地更改应用程序的 `frame-ancestors` 安全策略，使应用程序显示在 Simple Browser 中。 或者，如果某个 `frame-ancestors` 策略导致该问题，则应能够通过在常规浏览器选项卡中而不是在 Simple Browser 中打开应用程序来查看该应用程序。 若要实现该操作，请单击 VS Code 中的“端口”选项卡，右键单击该端口，然后单击“在浏览器中打开” 。\n\n
"}