GitHub Codespaces 日志

GitHub Codespaces 使用的日志概述。

本文内容

备注

  • 目前，在 JetBrains IDE 中使用 GitHub Codespaces 处于公开测试阶段，可能会发生变化。
  • 要在 JetBrains IDE 中处理代码空间，你必须使用 JetBrains Gateway 的版本 2023.3.* 或 2024.1.*。

有关 GitHub Codespaces 的信息会输出到各种日志

  • Codespace 日志
  • 创建日志
  • 浏览器控制台日志（适用于 VS Code Web 客户端）

如果你在 VS Code 中使用 GitHub Codespaces，则可以使用扩展日志。单击上方的“Visual Studio Code”选项卡以了解详情。

  • Codespace 日志
  • 创建日志
  • 扩展日志（适用于 VS Code 桌面应用程序）

如果你在浏览器中使用 GitHub Codespaces，则可以使用浏览器日志。单击上方的“Web 浏览器”选项卡以了解详情。

  • Codespace 日志
  • 创建日志

如果你在 VS Code 或 Web 浏览器中使用 GitHub Codespaces，则可以使用其他日志。单击上方的选项卡以了解详情。

  • 创建日志

如果你在 VS Code 或 Web 浏览器中使用 GitHub Codespaces，则可以使用其他日志。单击上方的选项卡以了解详情。

Codespace 日志

这些日志包含有关代码空间、容器、会话和 VS Code 环境的详细信息。它们可用于诊断连接问题和其他意外行为。例如，代码空间冻结，但“重新加载窗口”选项可使其在几分钟内解除冻结，或者你与代码空间随机断开连接，但能够立即重新连接。

  1. 如果您在浏览器中使用 GitHub Codespaces，请确保已连接到想要调试的 Codespace。
  2. 打开 VS Code 命令面板（Shift+Command+P（Mac）/ Ctrl+Shift+P（Windows/Linux）），然后键入导出日志。从列表中选择Codespaces：导出日志下载日志。
  3. 定义日志的 zip 存档的保存位置，然后单击保存（桌面）或单击确定（Web）。
  4. 如果您在浏览器中使用 GitHub Codespaces，请右键单击资源管理器视图中的日志的 zip 存档，然后选择下载…将它们下载到本地计算机。

Codespace 日志

这些日志包含有关代码空间、容器、会话和 VS Code 环境的详细信息。它们可用于诊断连接问题和其他意外行为。例如，代码空间冻结，但“重新加载窗口”选项可使其在几分钟内解除冻结，或者你与代码空间随机断开连接，但能够立即重新连接。

  1. 打开 VS Code 命令面板（Shift+Command+P（Mac）/ Ctrl+Shift+P（Windows/Linux）），然后键入导出日志。从列表中选择Codespaces：导出日志下载日志。
  2. 定义日志的 zip 存档的保存位置，然后单击保存（桌面）或单击确定（Web）。

Codespace 日志

这些日志包含有关代码空间、容器、会话和 VS Code 环境的详细信息。它们可用于诊断连接问题和其他意外行为。例如，代码空间冻结，但“重新加载窗口”选项可使其在几分钟内解除冻结，或者你与代码空间随机断开连接，但能够立即重新连接。

目前您无法使用 GitHub CLI 访问这些日志。要访问它们，请在 VS Code 或浏览器中打开您的 Codespace。

创建日志

这些日志包含有关容器、开发容器及其配置的信息。它们对于调试配置和设置问题非常有用。

  1. 连接到想要调试的 Codespace。
  2. 打开 VS Code 命令面板（Shift+Command+P（Mac）/ Ctrl+Shift+P（Windows/Linux）），然后键入创建日志。从列表中选择Codespaces：查看创建日志以打开creation.log文件。

如果您想与支持人员共享日志，可以将文本从创建日志复制到文本编辑器，然后在本地保存文件。

打开 VS Code 命令面板（Shift+Command+P（Mac）/ Ctrl+Shift+P（Windows/Linux）），然后键入创建日志。从列表中选择Codespaces：查看创建日志以打开creation.log文件。

如果您想与支持人员共享日志，可以将文本从创建日志复制到文本编辑器，然后在本地保存文件。

要详细了解 GitHub CLI，请参阅“关于 GitHub CLI”。

要查看创建日志，请使用gh codespace logs子命令。输入命令后，从显示的 Codespace 列表中进行选择。

gh codespace logs

有关此命令的更多信息，请参阅GitHub CLI 手册。

如果您想与支持人员共享日志，可以将输出保存到文件

gh codespace logs -c <CODESPACE-NAME> > /path/to/logs.txt

扩展日志

这些日志仅适用于 VS Code 桌面用户。如果 GitHub Codespaces 扩展或 VS Code 编辑器似乎存在阻止创建或连接的问题，它们非常有用。

  1. 在 VS Code 中，打开命令面板。
  2. 键入日志，然后选择开发者：打开扩展日志文件夹。
  3. 系统文件资源管理器显示，显示各种日志文件和文件夹。打开文件夹output_logging_DATETIME。

在此视图中，您可以访问 VS Code 中使用的扩展（包括 GitHub Codespaces）生成的日志。

浏览器控制台日志

这些日志仅在您想调试浏览器中使用 GitHub Codespaces 的问题时才很有用。它们对于调试创建和连接到 GitHub Codespaces 的问题很有用。

以下说明适用于 Chrome。其他浏览器的步骤类似。

  1. 在您想要调试的 Codespace 的浏览器窗口中，打开开发者工具窗口。

  2. 单击控制台选项卡。

  3. 显示控制台侧边栏（如果尚未显示）。有关更多信息，请参阅 Chrome 开发者文档中的“控制台功能参考”。

  4. 在侧边栏中，单击NUMBER 错误以仅显示错误。

  5. 在右侧的日志区域中，右键单击并选择另存为，将错误副本保存到您的本地计算机。

    Screenshot of the developer tools panel in the Chrome browser. The right-click menu is displayed, showing the option "Save as."

  1. 在 JetBrains 客户端中，单击 GitHub Codespaces 插件以显示 GitHub Codespaces 工具窗口。

    Screenshot of the GitHub Codespaces tool window. The "GitHub Codespaces" tool window selector is highlighted with an orange outline.

  2. 在 GitHub Codespaces 工具窗口中，单击日志图标。

    Screenshot of the log button (a book symbol).

JetBrains 日志

您可以通过转到 JetBrains 客户端应用程序中的帮助菜单并单击收集主机和客户端日志，下载远程 JetBrains IDE 和本地客户端应用程序的日志。

延伸阅读