跳至主要内容

使用 GitHub Codespaces 支持

关于如何从 GitHub Codespaces 支持获得最佳帮助的提示。

在支持人员能够帮助您解决 Codespaces 问题之前,您需要知道 Codespace 的永久名称及其 Codespaces ID(标识符)。此外,支持人员可能会要求您与他们共享一些日志。有关更多信息,请参阅“GitHub Codespaces 日志”和“关于 GitHub 支持”。

Codespace 名称

每个代码空间有两个名称:一个显示名称(您可以更改)和一个唯一的永久名称(您无法更改)。除非您使用 GitHub CLI 创建代码空间并指定您选择的显示名称,否则显示名称会在您创建代码空间时自动生成,它由两个或三个随机词组成——例如,literate space parakeet。永久名称是初始显示名称与一些随机字符的组合——例如,literate-space-parakeet-w5vg5ww5p793g7g9。如果您更改显示名称,永久名称将保持不变。更多信息,请参阅“重命名代码空间”。

您有时需要知道代码空间的永久名称。例如,当您使用某些 GitHub CLI 命令,或与 GitHub 支持人员讨论特定代码空间时。

要查找代码空间的永久名称,请执行以下操作之一:

  • 在浏览器中打开代码空间。URL 的子域是代码空间的名称。例如:https://obscure-space-engine-grx7rgg6qp43v9j5.github.devobscure-space-engine-grx7rgg6qp43v9j5 代码空间的 URL。
  • 如果您无法打开代码空间,您可以从位于 https://github.com/codespaces 的代码空间列表中访问其名称。右键单击代码空间的显示名称,然后选择浏览器中复制链接地址的选项。您复制的 URL 的最后一部分是代码空间的永久名称。
  • 在代码空间中,在终端中使用此命令:echo $CODESPACE_NAME
  • 如果已安装 GitHub CLI(本地或在代码空间中),请在终端中使用此命令列出所有代码空间:gh codespace list

代码空间的永久名称也包含在许多日志文件中。例如,在 GitHub Codespaces 扩展日志中,fetching codespaceConnecting to codespace之后,以及在浏览器控制台日志中 clientUrl之后。更多信息,请参阅“GitHub Codespaces 日志”。

代码空间 ID

每个代码空间也有一个 ID(标识符)。默认情况下,Visual Studio Code 中不会显示此 ID,因此您可能需要更新 GitHub Codespaces 扩展程序的设置才能访问此 ID。

  1. 在 Visual Studio Code(浏览器或桌面版)中,单击左侧活动栏上的**远程资源管理器**以显示代码空间的详细信息。

    注意

    如果活动栏中未显示远程资源管理器:

    1. 访问命令面板。例如,按 Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)。
    2. 键入:details
    3. 单击**代码空间:详细信息**。
  2. 如果侧边栏包含“代码空间性能”部分,请将鼠标悬停在**代码空间 ID** 上,然后单击剪贴板图标以复制 ID。

  3. 如果未显示信息,请单击活动栏左下角的 ,然后单击**设置**。

  4. 在**设置**选项卡中,搜索“performance”,然后在“GitHub > Codespaces:显示性能资源管理器”下,选中标有“在远程资源管理器中显示代码空间性能窗口”的复选框。

    Screenshot of "Show Performance Explorer" selected in VS Code's "Settings" tab and a codespace ID highlighted in the "Remote Explorer" side bar.