关于代码空间的创建
可以在 GitHub.com 上、Visual Studio Code 中或使用 GitHub CLI 创建代码空间。 您创建的每个代码空间只有您才可以使用。 其他任何人都不能在您的代码空间中工作。
代码空间与仓库的特定分支相关联,且仓库不能为空。 每个仓库甚至每个分支可创建多个代码空间。 However, each user account has a limit of 10 codespaces. 如果您已达到上限,想要创建一个新的代码空间,必须先删除一个旧代码空间。 更多信息请参阅“删除代码空间”。
创建代码空间时,需要执行一些步骤并将您连接到开发环境。
- 第 1 步:虚拟机和存储被分配到您的代码空间。
- 第 2 步:创建容器并克隆仓库。
- 第 3 步:您可以连接到代码空间。
- 第 4 步:代码空间继续创建后设置。
有关创建代码空间时会发生什么的更多信息,请参阅“深潜”。
有关代码空间生命周期的更多信息,请参阅“代码空间生命周期”。
如果要将 Git 挂钩用于代码空间,则应在步骤 4 中使用 devcontainer.json 生命周期脚本设置挂钩,例如 postCreateCommand。 由于代码空间容器是在克隆仓库后创建的,因此在容器映像中配置的任何 git template directory 将不适用于代码空间。 在创建代码空间后,必须改为安装挂钩。 有关使用 postCreateCommand 的更多信息,请参阅 visual Studio Code 文档中的 devcontainer.json 参考 。
使用 Visual Studio Code 在代码空间中开发时,您可以编辑代码、调试和使用 Git 命令。 更多信息请参阅 Visual Studio Code 文档。
您可以在 github.com/codespaces 上查看您创建的每一个可用代码空间。
To speed up codespace creation, repository administrators can enable Codespaces prebuilds for a repository. For more information, see "About Codespaces prebuilds."
访问 Codespaces
Codespaces are available for repositories owned by organizations using GitHub Team and GitHub Enterprise Cloud.
当您访问 Codespaces 时,在查看仓库时会看到 Code(代码)下拉菜单中的“Codespaces(代码空间)”选项卡。
在以下条件下,您可以访问代码空间:
- 您是已启用 Codespaces 并设定支出限额的组织的成员。
- 组织所有者已授予您访问 Codespaces。
- 仓库归启用 Codespaces 的组织所有。
注意: 已使用个人 GitHub 帐户加入测试版的个人不会失去 Codespaces 访问权限,但个人的 Codespaces 将继续保留在测试版中。
组织所有者可以允许组织的所有成员创建代码空间,将代码空间创建限制为选定的组织成员,或者禁用代码空间的创建。 有关管理对组织内代码空间的访问的更多信息,请参阅“为组织中的用户启用代码空间”。
在组织中使用 Codespaces 之前,所有者或帐单管理员必须设定支出限额。 更多信息请参阅“关于代码空间的支出限额”。
如果想为您的个人帐户或其他用户拥有的仓库创建代码空间, 并且您有权在已启用 Codespaces 的组织中创建仓库, 您可以将用户拥有的仓库复刻到该组织,然后为该复刻创建一个代码空间。
创建代码空间
-
在 GitHub.com 上,导航到仓库的主页面。
-
在仓库名称下,使用“Branch(分支)”下拉菜单选择您要为其创建代码的分支。

-
在存储库名称下,使用 代码下拉菜单,然后在Codespaces(代码空间)选项卡中,单击 New codespace(新建代码空间)。

如果您是组织的成员,并且在该组织拥有的仓库上创建代码空间,您可以选择不同机器类型的选项。 从对话框中选择机器类型,然后点击 Create codespace(创建代码空间)。

Note: Your choice of available machine types may be limited by a policy configured for your organization, or by a minimum machine type specification for your repository. For more information, see "Restricting access to machine types" and "Setting a minimum specification for codespace machines."
After you connect your account on GitHub.com to the GitHub Codespaces extension, you can create a new codespace.
-
在 Visual Studio Code 中,从左侧边栏单击 Remote Explorer 图标。

-
单击 Add(添加)图标,然后单击 Create New Codespace(创建新代码空间)。

-
键入,然后单击要在其中开发仓库的名称。

-
单击要在其中开发的分支。

-
Click the machine type you want to develop in.

Note: Your choice of available machine types may be limited by a policy configured for your organization, or by a minimum machine type specification for your repository. For more information, see "Restricting access to machine types" and "Setting a minimum specification for codespace machines."
要了解有关 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。
要创建新的代码空间,请使用 gh codespace create 子命令。
gh codespace create
系统将提示您选择仓库、分支和计算机类型(如果有多个可用)。
或者,您可以使用标志来指定部分或全部选项:
gh codespace create -r owner/repo -b branch -m machine-type
将 owner/repo 替换为仓库标识符。 将 branch 替换为您希望在代码空间中最初检出的分支的名称或提交的完整 SHA 哈希。 如果使用 -r 标志而不使用 b 标志,则将从默认分支创建代码空间。
将 machine-type 替换为可用计算机类型的有效标识符。 标识符是字符串,例如:basicLinux32gb 和 standardLinux32gb。 可用的计算机类型取决于仓库、您的用户帐户和您的位置。 如果输入无效或不可用的计算机类型,则错误消息中将显示可用类型。 如果省略此标志,并且有多个计算机类型可用,系统将提示您从列表中选择一个计算机类型。
有关此命令的详细信息,请参阅 GitHub CLI 手册。