{"meta":{"title":"GitHub Codespaces 日志","intro":"GitHub Codespaces 使用的日志概述。","product":"Codespaces","breadcrumbs":[{"href":"/zh/codespaces","title":"Codespaces"},{"href":"/zh/codespaces/troubleshooting","title":"故障排除"},{"href":"/zh/codespaces/troubleshooting/github-codespaces-logs","title":"Codespaces 日志"}],"documentType":"article"},"body":"# GitHub Codespaces 日志\n\nGitHub Codespaces 使用的日志概述。\n\n有关 GitHub Codespaces 的信息将输出到各种日志：\n\n<div class=\"ghd-tool webui\">\n\n* 代码空间日志\n* 创建日志\n* 浏览器控制台日志（用于 VS Code Web 客户端）\n\n如果要在 GitHub Codespaces 中使用 VS Code，则可以使用扩展日志。 单击上面的“Visual Studio Code”选项卡，了解详细信息。\n\n</div>\n\n<div class=\"ghd-tool vscode\">\n\n* 代码空间日志\n* 创建日志\n* 扩展日志（用于 VS Code 桌面应用程序）\n\n如果要在浏览器中使用 GitHub Codespaces，则可以使用浏览器日志。 单击上面的“Web 浏览器”选项卡，了解详细信息。\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n* 代码空间日志\n* 创建日志\n\n如果要在 GitHub Codespaces 或 Web 浏览器中使用 VS Code，则可以使用其他日志。 单击上面的选项卡以了解详细信息。\n\n</div>\n\n<div class=\"ghd-tool webui\">\n\n## 代码空间日志\n\n这些日志包含有关 codespace、容器、会话和 VS Code 环境的详细信息。 它们对于诊断连接问题和其他意外行为非常有用。 例如，代码空间冻结，但“Reload Windows（重新加载 Windows）”选项可将其解冻几分钟，或者您随机断开与代码空间的连接，但能够立即重新连接。\n\n1. 如果要在浏览器中使用 GitHub Codespaces，请确保已连接到要调试的 codespace。\n2. 打开 VS Code Command Palette （<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> （Mac）/ <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> （Windows/Linux））然后输入`export logs`。 从列表中选择“Codespaces: 导出日志”以下载日志。\n3. 定义保存日志 zip 存档的位置，然后单击“保存”（桌面），或单击“确定”(Web) 。\n4. 如果要在浏览器中使用 GitHub Codespaces，请右键单击“资源管理器”视图中日志的 zip 存档，然后选择“下载…” 将其下载到本地计算机。\n\n</div>\n\n<div class=\"ghd-tool vscode\">\n\n## 代码空间日志\n\n这些日志包含有关 codespace、容器、会话和 VS Code 环境的详细信息。 它们对于诊断连接问题和其他意外行为非常有用。 例如，代码空间冻结，但“Reload Windows（重新加载 Windows）”选项可将其解冻几分钟，或者您随机断开与代码空间的连接，但能够立即重新连接。\n\n1. 打开 VS Code Command Palette （<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> （Mac）/ <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> （Windows/Linux））然后输入`export log`。 从列表中选择“Codespaces: 导出日志”以下载日志。\n2. 定义保存日志 zip 存档的位置，然后单击“保存”（桌面），或单击“确定”(Web) 。\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n## 代码空间日志\n\n这些日志包含有关 codespace、容器、会话和 VS Code 环境的详细信息。 它们对于诊断连接问题和其他意外行为非常有用。 例如，代码空间冻结，但“Reload Windows（重新加载 Windows）”选项可将其解冻几分钟，或者您随机断开与代码空间的连接，但能够立即重新连接。\n\n目前，您无法使用 GitHub CLI 来访问这些日志。 要访问它们，请在 VS Code 或在一个浏览器中打开代码空间。\n\n</div>\n\n## 创建日志\n\n这些日志包含有关容器、开发容器及其配置的信息。 它们对于调试配置和设置问题非常有用。\n\n<div class=\"ghd-tool webui\">\n\n1. 连接到要调试的代码空间。\n2. 打开 VS Code Command Palette （<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> （Mac）/ <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> （Windows/Linux））然后输入`creation log`。 从列表中选择“Codespaces: 查看创建日志”以打开 \\*\\*\\*\\* 文件。\n\n如果要与支持人员共享日志，可以将创建日志中的文本复制到文本编辑器中，并将文件保存在本地。\n\n</div>\n\n<div class=\"ghd-tool vscode\">\n\n打开 VS Code Command Palette （<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> （Mac）/ <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> （Windows/Linux））然后输入`creation log`。 从列表中选择“Codespaces: 查看创建日志”以打开 \\*\\*\\*\\* 文件。\n\n如果要与支持人员共享日志，可以将创建日志中的文本复制到文本编辑器中，并将文件保存在本地。\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n> \\[!NOTE]\n> 若要详细了解 GitHub CLI，请参阅“[关于 GitHub CLI](/zh/github-cli/github-cli/about-github-cli)”。\n\n若要查看创建日志，请使用 `gh codespace logs` 子命令。 输入命令后，从显示的代码空间列表中进行选择。\n\n```shell\ngh codespace logs\n```\n\n有关此命令的详细信息，请参阅 [GitHub CLI 手册](https://cli.github.com/manual/gh_codespace_logs)。\n\n如果要与支持人员共享日志，可以将输出保存到一个文件中：\n\n```shell\ngh codespace logs -c <CODESPACE-NAME> > /path/to/logs.txt\n```\n\n</div>\n\n<div class=\"ghd-tool vscode\">\n\n## 扩展日志\n\n这些日志仅适用于 VS Code 桌面用户。 当 GitHub Codespaces 扩展或 VS Code 编辑器似乎遇到问题而无法创建或连接时，它们非常有用。\n\n1. 在 VS Code 中，打开命令面板。\n2. 键入 `logs`，然后选择**开发人员: 打开扩展日志文件夹**。\n3. 此时将显示系统的文件资源管理器，其中显示各种日志文件和文件夹。 打开 `output_logging_DATETIME` 文件夹。\n\n在此视图中，可以访问由在 VS Code 中使用的扩展生成的日志，包括 GitHub Codespaces。\n\n</div>\n\n<div class=\"ghd-tool webui\">\n\n## 浏览器控制台日志\n\n仅当想要调试在浏览器中使用 GitHub Codespaces 的问题时，这些日志才有用。 对于调试创建和连接到 GitHub Codespaces 的问题，它们非常有用。\n\n以下说明适用于 Chrome。 其他浏览器的执行步骤类似。\n\n1. 在要调试的代码空间的浏览器窗口中，打开开发人员工具窗口。\n2. 单击“控制台”\\*\\*\\*\\* 选项卡。\n3. 显示控制台边栏（如果尚未显示）。 有关详细信息，请参阅 Chrome 开发者文档中的[控制台功能参考](https://developer.chrome.com/docs/devtools/console/reference#sidebar)。\n4. 在边栏中，单击**错误数量**以仅显示错误。\n5. 在右侧的日志区域中，右键单击并选择“另存为”将错误的副本保存到本地计算机。\n\n   ![Chrome 浏览器中开发人员工具面板的屏幕截图。 将显示右键单击菜单，其中显示“另存为”选项。](/assets/images/help/codespaces/browser-console-log-save.png)\n\n</div>\n\n## 其他阅读材料\n\n* [审查您的组织的 GitHub Codespaces 审核日志](/zh/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)\n* [查看 GitHub Codespaces 的安全日志](/zh/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)"}