关于重命名 codespace
创建 codespace 时,会为其分配自动生成的显示名称。 如果有多个 codespace,则显示名称有助于区分不同 codespace。 例如:literate space parakeet
。 可以更改 codespace 的显示名称。
若要查找 codespace 的显示名称,请执行以下操作:
-
在 GitHub 上,在 https://github.com/codespaces 处查看 codespace 列表。
-
在 Visual Studio Code 桌面应用程序中,或在 VS Code Web 客户端中,单击远程资源管理器。 显示名称是列表中的第二项。 例如:以下屏幕截图中的
psychic chainsaw
。Note
如果远程资源管理器未显示在活动栏中:
- 访问命令面板。 例如,通过按 Shift+Command+P (Mac)/Ctrl+Shift+P (Windows/Linux)。
- 键入:
details
。 - 单击“Codespace: 详细信息”。
-
在本地计算机上的终端窗口中,使用这条 GitHub CLI 命令:
gh codespace list
。
永久 codespace 名称
除了显示名称,每个 CodeSpace 还具有唯一的永久名称。 永久名称是初始显示名称后跟一些随机字符的组合,例如 literate-space-parakeet-w5vg5ww5p793g7g9
。 无法更改永久名称。
有时需要知道 CodeSpace 的永久名称。 例如,使用某些 GitHub CLI 命令时,或者讨论具有 GitHub 支持的特定 CodeSpace 时。
要查找 Codespace的永久名称,请执行以下操作:
- 在浏览器中打开代码空间。 URL 的子域是代码空间的名称。 例如:
https://obscure-space-engine-grx7rgg6qp43v9j5.github.dev
是obscure-space-engine-grx7rgg6qp43v9j5
codespace 的 URL。 - 如果无法打开 Codespace,可从 https://github.com/codespaces 上的 Codespace 列表中访问该名称。 右键单击 Codespace 的显示名称,然后选择浏览器用于复制链接地址的选项。 复制的 URL 的最后一部分是 Codespace 的永久名称。
- 在 codespace 中,在终端中使用此命令:
echo $CODESPACE_NAME
。 - 如果在本地或 Codespace 中安装了 GitHub CLI,请在终端中使用以下命令列出所有 Codespace:
gh codespace list
。
Codespace 的永久名称也包含在许多日志文件中。 例如,在 GitHub Codespaces 扩展日志中,位于 fetching codespace
或 Connecting 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'
在本例中,用想要更改其显示名称的 codespace 的永久名称替换 PERMANENT-CODESPACE-NAME
。 用想用于此 codespace 的显示名称替换 NEW-DISPLAY-NAME
。
显示名称最长可为 48 个字符。 显示名称可以包含字符(包括空格)的任意组合,前提是你要将其括在单引号中。
有关详细信息,请参阅“将 GitHub Codespaces 与 GitHub CLI 配合使用”。
可以使用 GitHub 更改 codespace 的显示名称。
-
在 GitHub 的左上角,选择 ,然后单击“ Codespace”,转到 github.com/codespaces 上的“你的 codespace”页面。
The current display name for each of your codespaces is displayed.
-
单击要修改的 codespace 右侧的省略号 (...)。
-
单击“重命名”。
-
在提示符中,在“将显示名称更改为...”下键入所需的显示名称,然后单击“ 确定”。