重命名 Codespace

关于重命名 Codespace

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

查找 Codespace 的显示名称

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

  

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

  

  注意

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

  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.dev 是 obscure-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 codespace 或 Connecting to codespace 之后，以及在浏览器控制台日志中 clientUrl 之后。更多信息，请参阅“GitHub Codespaces 日志”。

重命名 codespace

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

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

进一步阅读

• “设置您的用户偏好设置”
• “管理您的 codespaces”