GitHub Codespaces 客户端故障排除

Visual Studio Code 网页客户端疑难解答

如果您在非 Chromium 浏览器中使用 GitHub Codespaces 时遇到问题，请尝试切换到基于 Chromium 的浏览器，例如 Google Chrome 或 Microsoft Edge。或者，您可以在 microsoft/vscode 存储库中搜索标记为您的浏览器名称的问题，例如 firefox 或 safari，以查看您的浏览器是否存在已知问题。

如果您在基于 Chromium 的浏览器中使用 GitHub Codespaces 时遇到问题，您可以检查您是否在 microsoft/vscode 存储库中遇到了 VS Code 的其他已知问题。

与在本地 VS Code 中工作的区别

当您在浏览器中使用 VS Code 网页客户端打开 codespace 时，您会注意到与在 VS Code 桌面应用程序中使用本地工作区相比，有一些区别。例如，一些键绑定可能不同或缺失，一些扩展可能表现不同。有关摘要，请参阅 VS Code 文档中的“已知限制和调整”。

您可以在 microsoft/vscode 存储库中检查已知问题并记录 VS Code 体验的新问题。

Visual Studio Code Insiders

Visual Studio Code Insiders 是 VS Code 最频繁的版本。它包含所有最新的功能和错误修复，但也可能偶尔包含导致构建失败的新问题。

如果您使用的是 Insiders 版本并注意到行为异常，建议您切换到 Visual Studio Code Stable 并重试。

点击 编辑器左下角，然后选择切换到稳定版本...。如果 VS Code 网页客户端无法加载，或者 不可用，您可以通过将 ?vscodeChannel=stable 附加到您的 codespace URL 并加载该 URL 上的 codespace 来强制切换到 Visual Studio Code Stable。

如果 Visual Studio Code Stable 中的问题没有解决，请检查已知问题，并在需要时在 microsoft/vscode 存储库中记录 VS Code 体验的新问题。

简单浏览器故障排除

在代码空间中启动 Web 应用程序后，您可以在 VS Code 中嵌入的简单浏览器中预览正在运行的应用程序。在某些项目中，应用程序在启动时会自动在编辑器中的简单浏览器选项卡中打开。如果代码空间的 `devcontainer.json` 配置文件中，应用程序运行的端口的 `onAutoForward` 属性设置为 `openPreview`，则会发生这种情况。

"portsAttributes": {
  "3000": {
    "label": "Application",
    "onAutoForward": "openPreview"
  }
}

如果简单浏览器选项卡没有自动打开，您可以手动打开简单浏览器以查看应用程序。

1. 在 VS Code 中，单击 **端口** 选项卡。

2. 右键单击端口，然后单击 **在编辑器中预览**。

   

简单浏览器选项卡没有自动打开

如果 `devcontainer.json` 配置文件为端口指定了 `"onAutoForward": "openPreview"`，但应用程序启动时简单浏览器没有自动打开，请检查应用程序是否已在配置中指定的端口上启动。如果目标端口繁忙，应用程序可能会在其他端口上启动。

为了实现 `devcontainer.json` 中指定的端口配置，GitHub Codespaces 会在创建代码空间时将配置写入 VS Code 的 `settings.json` 文件。您可以检查配置是否已正确写入代码空间中的 `settings.json`。

1. 在代码空间的终端中，输入以下命令。

   Bash

   cat ~/.vscode-remote/data/Machine/settings.json
   

2. 验证 `settings.json` 文件是否包含以下类似的代码行。

    "remote.portsAttributes": {
        "3000": {
            "label": "Application",
            "onAutoForward": "openPreview"
        }
    }
   

如果 `settings.json` 文件不包含这些设置，请检查您是否启用了点文件，以及您的点文件中是否有任何配置覆盖了 `settings.json` 文件。有关更多信息，请参阅 "为您的帐户个性化 GitHub Codespaces。"。

应用程序未加载

有时，您可能会发现简单浏览器选项卡已打开，但显示错误页面图标或空白页面，而不是正在运行的应用程序。如果要加载的 Web 应用程序包含内容安全策略 (CSP)，该策略限制了网站页面可以嵌入其中的域，则可能会发生这种情况。有关更多信息，请参阅 mdn 网站上的 CSP: frame-ancestors。

您可能需要在本地更改应用程序的frame-ancestors安全策略，以便应用程序在简单浏览器中显示。或者，如果frame-ancestors策略导致了问题，您应该能够通过在常规浏览器选项卡中打开应用程序来查看它，而不是在简单浏览器中。为此，请在 VS Code 中单击**端口**选项卡，右键单击端口，然后单击**在浏览器中打开**。