Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

重命名 codespace

可以通过 GitHub.com 或 GitHub CLI 将 codespace 显示名称更改为所选名称之一。

关于重命名 codespace

为每个 codespace 分配一个自动生成的显示名称。 如果有多个 codespace,则显示名称有助于区分不同 codespace。 例如:literate space parakeet。 可以更改 codespace 的显示名称。

若要查找 codespace 的显示名称,请执行以下操作:

  • 在 GitHub Enterprise Cloud 上,在 https://github.com/codespaces 处查看 codespace 列表。

    GitHub 中 codespace 列表的屏幕截图

  • 在 Visual Studio Code 桌面应用程序中,或在 VS Code Web 客户端中,单击远程资源管理器。 显示名称是列表中的第二项。 例如:以下屏幕截图中的 symmetrical space telegram

    VS Code 中远程资源管理器的屏幕截图

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

    1. 访问命令面板。 例如,通过按 Shift+Command+P (Mac)/Ctrl+Shift+P (Windows/Linux)。
    2. 键入:codespaces
    3. 单击“Codespace: 详细信息”。
  • 在本地计算机上的终端窗口中,使用这条 GitHub CLI 命令:gh codespace list

永久 codespace 名称

创建 codespace 时,除了显示名称,还会向 codespace 分配永久名称。 该名称是 GitHub 句柄以及自动生成的显示名称的组合。 例如:octocat-literate-space-parakeet-mld5。 无法更改永久名称。

若要查找 codespace 的永久名称,请执行以下操作:

  • 在 GitHub Enterprise Cloud 上,将鼠标悬停在 https://github.com/codespaces 上 codespace 的显示名称上时,永久名称会显示在弹出窗口中。

    悬停时显示的 codespace 名称的屏幕截图

  • 在 codespace 中,在终端中使用此命令:echo $CODESPACE_NAME

  • 在本地计算机上的终端窗口中,使用这条 GitHub CLI 命令:gh codespace list

重命名 codespace

如果有多个要在较长时间内使用的 codespace,更改 codespace 的显示名称可能很有用。 适当的名称有助于识别用于特定用途的 codespace。

可以使用 GitHub CLI 更改 codespace 的显示名称。

若要为 codespace 重命名,请使用 gh codespace edit 子命令:

gh codespace edit -c PERMANENT-CODESPACE-NAME -d NEW-DISPLAY-NAME

在本例中,用想要更改其显示名称的 codespace 的永久名称替换 PERMANENT-CODESPACE-NAME。 用想用于此 codespace 的显示名称替换 NEW-DISPLAY-NAME

有关详细信息,请参阅“将 GitHub Codespaces 与 GitHub CLI 配合使用

可以在 GitHub.com 上更改 codespace 的显示名称。

  1. 导航到 github.com/codespaces 上的“你的 codespace”页面。

    The current display name for each of your codespaces is displayed.

  2. 单击要修改的 codespace 右侧的省略号 (...)。

  3. 单击“重命名”。

  4. 在提示符中,在“将显示名称更改为...”下键入所需的显示名称,然后单击“ 确定”。