关于重命名 Codespace
创建 Codespace 时,会为其分配一个自动生成的显示名称。如果您有多个 Codespace,显示名称可以帮助您区分不同的 Codespace。例如:literate space parakeet
。您可以更改 Codespace 的显示名称。
要查找 Codespace 的显示名称
-
在 GitHub 上,您可以在 https://github.com/codespaces 查看您的代码空间列表。
-
在 Visual Studio Code 桌面应用程序或 VS Code 网页客户端中,单击远程资源管理器。显示名称是列表中的第二个项目。例如:以下屏幕截图中的
psychic chainsaw
。注意:如果活动栏中未显示远程资源管理器
- 访问命令面板。例如,按 Shift+Command+P(Mac)/ Ctrl+Shift+P(Windows/Linux)。
- 输入:
details
。 - 单击代码空间:详细信息。
-
在本地机器上的终端窗口中,使用以下 GitHub CLI 命令:
gh codespace list
。
永久代码空间名称
除了显示名称之外,每个代码空间还具有唯一的永久名称。永久名称是初始显示名称与一些随机字符的组合,例如 literate-space-parakeet-w5vg5ww5p793g7g9
。您无法更改永久名称。
您有时需要知道代码空间的永久名称。例如,当您使用某些 GitHub CLI 命令或与 GitHub 支持人员讨论特定代码空间时。
要查找代码空间的永久名称,请执行以下操作之一
- 在浏览器中打开代码空间。URL 的子域是代码空间的名称。例如:
https://obscure-space-engine-grx7rgg6qp43v9j5.github.dev
是obscure-space-engine-grx7rgg6qp43v9j5
代码空间的 URL。 - 如果您无法打开代码空间,则可以从您的代码空间列表中访问该名称,网址为 https://github.com/codespaces。右键单击代码空间的显示名称,然后选择浏览器中用于复制链接地址的选项。您复制的 URL 的最后部分是代码空间的永久名称。
- 在代码空间中,在终端中使用以下命令:
echo $CODESPACE_NAME
。 - 如果 GitHub CLI 已安装(本地或在代码空间中),请在终端中使用以下命令列出所有代码空间:
gh codespace list
。
代码空间的永久名称也包含在许多日志文件中。例如,在 GitHub 代码空间扩展日志中,在 fetching codespace
或 Connecting to codespace
之后,以及在浏览器控制台日志中,在 clientUrl
之后。有关更多信息,请参阅“GitHub 代码空间日志”。
重命名代码空间
如果您有多个代码空间将在较长时间内使用,更改代码空间的显示名称可能很有用。合适的名称有助于您识别用于特定目的的代码空间。
如果您已安装 GitHub CLI,则可以使用它来使用 GitHub 代码空间。有关 GitHub CLI 的安装说明,请参阅 GitHub CLI 存储库。
要更改代码空间的显示名称,请使用 gh codespace edit
子命令
gh codespace edit -c PERMANENT-CODESPACE-NAME -d 'NEW-DISPLAY-NAME'
在本示例中,将 PERMANENT-CODESPACE-NAME
替换为要更改显示名称的 codespace 的永久名称。将 NEW-DISPLAY-NAME
替换为要用于此 codespace 的显示名称。
显示名称的长度最多可达 48 个字符。显示名称可以包含任何字符组合,包括空格,但前提是您需要将其用单引号括起来。
有关更多信息,请参阅“使用 GitHub Codespaces 与 GitHub CLI”。
您可以在 GitHub.com 上更改 codespace 的显示名称。
-
在 GitHub.com 的左上角,选择 ,然后单击 Codespaces 以转到 github.com/codespaces 上的“您的 codespaces”页面。
将显示每个 codespace 的当前显示名称。
-
单击要修改的 codespace 右侧的省略号 (...)。
-
单击重命名。
-
在提示中,在“将显示名称更改为...”下键入您想要的显示名称,然后单击确定。