跳至主要内容

重命名 codespace

您可以在 GitHub 上或使用 GitHub CLI 更改 codespace 显示名称为您选择的名称。

关于重命名 codespace

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

查找 codespace 的显示名称

  • 在 GitHub 上,在https://github.com/codespaces查看您的 codespace 列表。

    Screenshot of a list of three codespaces on the https://github.com/codespaces page."

  • 在 Visual Studio Code 桌面应用程序或 VS Code 网页客户端中,单击远程资源管理器。显示名称是列表中的第二项。例如,下图中的显示名称为:psychic chainsaw

    Screenshot of the "Remote Explorer" in VS Code. The codespace display name, "psychic chainsaw," is highlighted with a dark orange outline.

    注意

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

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

Codespace 永久名称

除了显示名称外,每个 Codespace 还拥有一个唯一的永久名称。永久名称是由初始显示名称和一些随机字符组合而成,例如:literate-space-parakeet-w5vg5ww5p793g7g9。您无法更改永久名称。

您有时需要知道 Codespace 的永久名称。例如,当您使用某些 GitHub CLI 命令或与 GitHub 支持团队讨论特定 Codespace 时。

要查找 Codespace 的永久名称,请执行以下任一操作:

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

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

重命名 Codespace

如果您有多个 Codespace 将长期使用,则更改 Codespace 的显示名称可能很有用。合适的名称可以帮助您识别用于特定用途的 Codespace。

如果您已安装 GitHub CLI,则可以使用它来使用 GitHub Codespaces。有关 GitHub CLI 安装说明,请参阅 GitHub CLI 代码库

要更改 Codespace 的显示名称,请使用 gh codespace edit 子命令。

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

在此示例中,请将 PERMANENT-CODESPACE-NAME 替换为要更改其显示名称的 Codespace 的永久名称。将 NEW-DISPLAY-NAME 替换为您要为此 Codespace 使用的显示名称。

显示名称最多可包含 48 个字符。显示名称可以包含任何字符组合,包括空格,但前提是您需要将其放在单引号中。

更多信息,请参阅“使用 GitHub CLI 使用 GitHub Codespaces”。

您可以在 GitHub 上更改 Codespace 的显示名称。

  1. 在 GitHub 的左上角,选择,然后单击 Codespaces 将您带到 github.com/codespaces 上的“您的 Codespaces”页面。

    将显示每个 Codespace 的当前显示名称。

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

  3. 单击重命名

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

进一步阅读