您可以在 GitHub、Visual Studio Code 或使用 GitHub CLI 重新打开任何活动或已停止的代码空间。已删除的代码空间无法重新打开。请参阅代码空间生命周期概述。
您可以在github.com/codespaces的“Your codespaces”页面查看所有代码空间。从该页面,您可以
- 打开、停止或删除您的代码空间。
- 查看代码空间的所有者(以及可能的计费对象):个人账号或您所属的组织。请参阅GitHub Codespaces 计费。
- 查看代码空间的机器类型、规格和状态。
- 创建新代码空间,可选择 GitHub 的模板或点击New codespace。请参阅从模板创建代码空间以及为仓库创建代码空间。
- 防止代码空间被自动删除。请参阅配置代码空间自动删除。
从仓库页面恢复代码空间
在浏览仓库时,您可以快速恢复代码空间。
-
在 GitHub 上显示的仓库的 代码选项卡中,按下 ,(逗号键)。
会显示“恢复代码空间”页面。此页面可让您恢复当前分支(或若正在查看 Pull Request,则为该 PR 的目标分支)最近使用的代码空间。

-
点击恢复此代码空间。
或者,如果您想为该仓库的此分支创建一个新代码空间,点击创建一个新代码空间。
注意
如果此分支没有现有代码空间,页面标题为“创建代码空间”,并显示一个标有创建新代码空间的按钮。
您可以将此页面的地址加入书签,以便快速返回恢复代码空间。也可以把该地址放在链接中,向他人提供快速创建并恢复该仓库代码空间的方式。
从“Your codespaces”页面打开现有代码空间
-
在 GitHub 左上角,选择,然后点击 Codespaces 以打开位于 github.com/codespaces 的 “Your codespaces” 页面。
-
要在默认编辑器中打开代码空间,点击代码空间的名称。您可以在个人设置页面为 Codespaces 设置默认编辑器。请参阅为 GitHub Codespaces 设置默认编辑器。
在默认编辑器之外的编辑器中打开代码空间
- 点击想打开的代码空间右侧的省略号(...)。
- 点击打开方式。
- 点击在 APPLICATION 中打开。
您可以在以下位置打开代码空间
- 浏览器
- Visual Studio Code
- JupyterLab
如果您选择 Visual Studio Code(桌面应用),必须确保在本地机器上已安装 VS Code。
如果您选择 JupyterLab,则必须在代码空间中安装 JupyterLab 应用程序。默认的开发容器镜像已经包含 JupyterLab,因此使用默认镜像创建的代码空间始终会预装 JupyterLab。有关默认镜像的更多信息,请参阅 开发容器入门 以及
devcontainers/images仓库。如果您的 dev container 配置未使用默认镜像,可通过在devcontainer.json文件中添加ghcr.io/devcontainers/features/python特性来安装 JupyterLab。您应加入选项"installJupyterlab": true。更多信息,请参阅devcontainers/features仓库中python特性的 README。
链接到现有代码空间
您可以为已有的代码空间创建链接。这在您有长期保留且经常返回的代码空间时非常有用。您可以将链接保存在任意位置,作为访问https://github.com/codespaces 的替代方式。
注意
只能打开您自己的代码空间。若他人点击指向您代码空间的链接,则会看到 404 错误。
使用以下任意 URL 模式创建链接。在这些 URL 中,CODESPACE-NAME 代表代码空间的唯一永久名称,例如 literate-space-parakeet-w5vg5ww5p793g7g9,而不是显示名称。您可以在https://github.com/codespaces 页面复制代码空间的链接并从 URL 中提取代码空间名称。
| 链接打开方式 | 链接语法 |
|---|---|
| VS Code 网页客户端 | https://CODESPACE-NAME.github.dev |
| 带指定工作区的 VS Code 网页客户端 | https://CODESPACE-NAME.github.dev?folder=/workspaces/PATH/TO/WORKSPACE/DIRECTORY |
| VS Code 桌面应用 | https://github.com/codespaces/CODESPACE-NAME?editor=vscode |
| JupyterLab | https://github.com/codespaces/CODESPACE-NAME?editor=jupyter |
重新打开现有代码空间
注意
要在 VS Code 中使用 GitHub Codespaces,需安装 Codespaces 扩展。请参阅在 Visual Studio Code 中使用 GitHub Codespaces。
-
在 VS Code 桌面应用中,使用 Command+Shift+P(Mac)或 Ctrl+Shift+P(Windows/Linux)打开命令面板。
-
输入 “Codespaces” 并选择下面的任意命令。
- 要在 VS Code 的新窗口中打开代码空间,选择Codespaces: Open Codespace in New Window
- 要在网页编辑器中打开代码空间,选择Codespaces: Open in Browser
-
点击您想打开的代码空间。

您也可以通过在 VS Code 中打开“Remote Explorer”视图并右键点击想要打开的代码空间来访问上述命令。

注意
如果活动栏中未显示 Remote Explorer
- 打开命令面板。例如,按 Shift+Command+P(Mac)或 Ctrl+Shift+P(Windows/Linux)。
- 输入:
details。 - 点击 Codespaces: Details。
链接到现有代码空间
您可以为已有的代码空间创建链接。这在您有长期保留且经常返回的代码空间时非常有用。您可以将链接保存在任意位置,作为访问https://github.com/codespaces 的替代方式。
注意
只能打开您自己的代码空间。若他人点击指向您代码空间的链接,则会看到 404 错误。
使用以下任意 URL 模式创建链接。在这些 URL 中,CODESPACE-NAME 代表代码空间的唯一永久名称,例如 literate-space-parakeet-w5vg5ww5p793g7g9,而不是显示名称。您可以在https://github.com/codespaces 页面复制代码空间的链接并从 URL 中提取代码空间名称。
| 链接打开方式 | 链接语法 |
|---|---|
| VS Code 网页客户端 | https://CODESPACE-NAME.github.dev |
| 带指定工作区的 VS Code 网页客户端 | https://CODESPACE-NAME.github.dev?folder=/workspaces/PATH/TO/WORKSPACE/DIRECTORY |
| VS Code 桌面应用 | https://github.com/codespaces/CODESPACE-NAME?editor=vscode |
| JupyterLab | https://github.com/codespaces/CODESPACE-NAME?editor=jupyter |
重新打开现有代码空间
如果您已安装 GitHub CLI,可以使用它来管理 GitHub Codespaces。有关 GitHub CLI 的安装说明,请参阅 GitHub CLI 仓库。
-
在终端中,输入以下任一 GitHub CLI 命令。
-
要在 VS Code 中打开代码空间,输入
Shell gh codespace code
gh codespace code注意
本地机器必须已安装 VS Code。请参阅 VS Code 文档中的VS Code 安装与设置概览。
-
要在浏览器中打开代码空间,输入
Shell gh codespace code --web
gh codespace code --web -
要在 JupyterLab 中打开代码空间,输入
Shell gh codespace jupyter
gh codespace jupyter注意
必须在您打开的代码空间中安装 JupyterLab 应用程序。默认的开发容器镜像已经包含 JupyterLab,因此使用默认镜像创建的代码空间始终会预装 JupyterLab。有关默认镜像的更多信息,请参阅 开发容器入门 以及
devcontainers/images仓库。如果您的 dev container 配置未使用默认镜像,可通过在devcontainer.json文件中添加ghcr.io/devcontainers/features/python特性来安装 JupyterLab。您应加入选项"installJupyterlab": true。更多信息,请参阅devcontainers/features仓库中python特性的 README。 -
要通过 SSH 从命令行访问代码空间,输入
Shell gh codespace ssh
gh codespace ssh
-
-
使用方向键,定位到您想打开的代码空间。
-
按 Enter 打开代码空间。
请参阅 GitHub CLI 手册中的 gh codespace code。