Skip to main content

什么是 GitHub Codespaces?

了解 GitHub Codespaces 是什么。

简介

代码空间是托管在云中的开发环境。 可通过将配置文件提交到存储库(通常称为“配置即代码”)来为 GitHub Codespaces 自定义项目,这将为项目的所有用户创建可重复的 codespace 配置。 请参阅 开发容器简介

创建的每个 codespace 都由 GitHub 托管在虚拟机上运行的 Docker 容器中。 可以从多种虚拟机类型中选择,从 2 核、8 GB RAM 和 32 GB 存储,到最多 32 核、64 GB RAM 和 128 GB 存储。

默认情况下,codespace 开发环境是基于 Ubuntu Linux 映像创建的,该映像包含各种常用的语言和工具,但也可以使用基于所选 Linux 发行版的映像,并根据你的特定要求对其进行配置。 无论本地操作系统是什么,codespace 都将在 Linux 环境中运行。 远程开发容器不支持 Windows 和 macOS 操作系统。

可以从浏览器、Visual Studio Code 或使用 GitHub CLI 连接到 codespace。 连接时,你将位于 Docker 容器中。 对于外部 Linux 虚拟主机,你只有有限的访问权限。

关系图显示代码编辑器与 Azure 虚拟机上运行的 codespace 之间的关系。

使用 GitHub Codespaces

要开始使用基于云的计算资源进行开发,可以通过模板或存储库中的任何分支或提交创建 codespace。 通过模板创建 codespace 时,可以从空白模板开始,也可以选择适合你正在做的工作的模板。

若要开始使用 GitHub Codespaces,请参阅“GitHub Codespaces 快速入门”。 有关创建 codespace 的详细信息,请参阅“为存储库创建 codespace”或“通过模板创建 codespace”。 如果要返回到已创建的 codespace,请参阅“打开现有 codespace”。 若要详细了解 GitHub Codespaces 的工作原理,请参阅“深入了解 GitHub Codespaces”。

使用个人帐户拥有的 codespaces

所有个人 GitHub 帐户都有免费或专业版计划中包含的 GitHub Codespaces 的每月免费使用配额。 无需更改任何设置或提供付款详细信息,即可在个人帐户上开始使用 GitHub Codespaces。

如果通过组织拥有的存储库创建 codespace,则 codespace 的使用按照组织(如果组织对此进行了配置)或个人帐户进行计费。

通过提供付款详细信息和设置支出限制,可以在超出每月包含的存储空间和计算使用量后继续使用 GitHub Codespaces。 请参阅“关于 GitHub Codespaces 的计费”。

使用组织拥有的 codespaces

GitHub Team 和 GitHub Enterprise 计划的组织所有者可以为其成员和协作者对 GitHub Codespaces 的使用付费。 这适用于通过组织拥有的存储库创建的 codespaces。 请参阅 选择谁拥有组织中的 codespace 并为其付费。 可以对组织或企业帐户上的 GitHub Codespaces 使用设置支出限制。 请参阅 管理 GitHub Codespaces 的支出限制

如果按照组织或企业对 codespace 的使用进行计费,则会在创建 codespace 时显示。 请参阅 为存储库创建 codespace。 按照组织或其父企业计费的 codespace 归组织所有,且可被组织所有者删除。 请参阅 删除代码空间

能否从组织拥有的存储库创建 codespace 取决于多个因素,包括存储库的可见性以及组织或其父企业的设置。 有关详细信息,请参阅“codespace 的创建和删除故障排除”。

自定义 GitHub Codespaces

若要自定义 codespace 中的运行时和工具,可以为存储库创建一个或多个开发容器配置。 将开发容器配置添加到存储库后,可以定义适合用户将在存储库中执行的工作的不同开发环境选择。

如果通过没有任何开发容器配置的仓库创建 codespace,GitHub Codespaces 会将仓库克隆到具有默认开发容器映像的环境中,该映像包含许多工具、语言和运行时环境。 如果通过模板创建 codespace,则可以从默认映像之上的一些初始配置开始。 请参阅 开发容器简介

可使用公共点文件存储库对 codespace 环境的各个方面进行个性化设置。 可使用点文件设置 shell 别名和首选项,也可安装喜欢使用的工具的个人首选项。 如果在浏览器或 Visual Studio Code 中使用 GitHub Codespaces,则可以使用设置同步为 codespace 编辑器提供在本地安装 Visual Studio Code 中设置的相同设置、键盘快捷方式、片段和扩展。

请参阅 自定义代码空间

Codespaces

的计费

有关 GitHub Codespaces 的定价、存储和使用情况信息,请参阅 关于 GitHub Codespaces 的计费

Note

必须为个人、组织或企业帐户设置非零支出限制,然后才能向帐户对 GitHub Codespaces 的使用进行计费。

默认情况下,所有帐户的 GitHub Codespaces 支出限制为 0 美元。 这可以防止创建新的 codespace 或打开现有 codespace,如果执行这些操作,将对个人、组织或企业帐户产生可计费成本。 对于个人帐户,如果你有权创建 codespace,只要帐户还没有达到其每月包含的使用量限制,就可以执行此操作。 对于组织和企业,默认支出限制意味着,要允许用户创建向组织或其父企业计费的 codespace,必须将限制更改为高于 0 美元的值。

始终按月计算 GitHub Codespaces 的费用,即使你的帐户按年计费也是如此。 有关组织所有者和计费管理员如何管理组织的 GitHub Codespaces 支出限制的信息,请参阅 管理 GitHub Codespaces 的支出限制