Skip to main content

通过模板创建 codespace

如果要启动新项目,可以通过空白模板创建 codespace,或者选择专为你要执行的工作类型设计的模板。

关于适用于 GitHub Codespaces 的模板

如果要启动新项目,可以通过从模板创建 codespace 来快速开始开发工作。 你将能够在基于云的开发环境中处理项目、将文件保存在云中,以及将工作发布到可与他人共享或克隆到本地计算机的新远程存储库中。

可以从空白模板开始着手,从 GitHub 维护的模板中选择 React 或 Jupyter Notebook 等常用技术,或者从 GitHub 上的任何模板存储库中启动 codespace。

使用空白模板时,你将从空目录开始创建,并且可以访问基于云的计算资源,以及预安装了默认 codespace 映像的工具、语言和运行时环境。 使用其他模板时,你将获得当前所用技术的入门文件,通常还有一些额外文件,例如自述文件、.gitignore 文件和包含一些自定义环境配置的开发容器配置文件。 有关开发容器和默认映像的详细信息,请参阅“开发容器简介”。

例如,如果通过 GitHub 的React 模板创建 codespace,则将到达包含简单应用程序的模板文件的工作区中,例如 index.jsapp.jspackage.json。 在 codespace 打开后不久,开发服务器将自动启动,并且你将能够在 VS Code Web 客户端内的简单浏览器选项卡中查看正在运行的应用程序。

VS Code 的简单浏览器的屏幕截图,其中显示 GitHub 的 React 模板中的 Web 应用程序。

模板中包含的文件和配置在模板存储库中定义。 创建 codespace 时,模板存储库将克隆到 codespace 中。 之后,链接将被切断,并且 codespace 将不会链接到远程存储库,直到你发布到远程存储库为止。

提示:为了帮助用户开始使用你的框架、库或其他项目,你可以设置模板存储库,以便与 GitHub Codespaces 配合使用。 有关详细信息,请参阅“为 GitHub Codespaces 设置模板存储库”。

通过 GitHub 模板创建 codespace

GitHub 维护的模板(包括空白模板)在“你的 codespace”页中提供。

  1. 导航到 github.com/codespaces 上的“你的 codespace”页面。

  2. 若要查看模板的完整列表,请在“浏览快速入门模板”部分,单击“查看全部”。

    “探索快速入门模板”部分的屏幕截图。 “查看全部”以深橙色边框突出显示。

  3. (可选)若要查看包含模板文件的模板存储库,请单击模板的名称。

    codespaces 页的“浏览快速入门模板”部分的屏幕截图。 列出了三个模板,模板的名称用橙色边框突出显示。

  4. 在要启动的模板名称下,单击“使用此模板”。

从模板创建新的 codespace 时,始终会在 Visual Studio Code Web 客户端中打开它。 可以在任何受支持的编辑器中重新打开现有 codespace。 有关详细信息,请参阅“打开现有 codespace”。

通过模板存储库创建 codespace

可以通过任何模板存储库创建 codespace,然后在准备就绪后将工作发布到新存储库。 有关模板存储库的详细信息,请参阅“从模板创建仓库”。

  1. 在 GitHub.com 上,导航到存储库的主页。

  2. 单击“使用此模板”,然后单击“在 codespace 中打开”。

    屏幕截图显示“使用此模板”按钮和展开的下拉菜单,其中显示了“在 codespace 中打开”选项。

    注意:如果你是模板存储库的维护者,并且要将更改提交到模板存储库本身,则应通过“ 代码”下拉列表创建 codespace 。 有关详细信息,请参阅“为存储库创建 codespace”。

从模板创建新的 codespace 时,始终会在 Visual Studio Code Web 客户端中打开它。 可以在任何受支持的编辑器中重新打开现有 codespace。 有关详细信息,请参阅“打开现有 codespace”。

发布到 GitHub

上的存储库

在从模板创建的 codespace 中工作时,你的工作将保存在云中的虚拟机上,但不会存储在 GitHub 上的存储库中。

可以保存文件、关闭并停止 codespace,稍后再返回工作。 通常会预安装 Git,工作目录将自动初始化为 Git 存储库,除非你从 GitHub 的空白模板开始。 这意味着可以立即使用 Git 进行本地源代码管理,例如添加和提交文件。

但是,如果删除未发布的 codespace,或者该 codespace 由于在保持期内未使用而被自动删除,则你的工作也会被删除。 若要持久保存你的工作并允许其他人处理你的项目,你需要将 codespace 发布到 GitHub 上的存储库。

注意:如果当前向组织收取未发布的 codespace 费用,则发布 codespace 会将 codespace 的所有权和计费转移到个人帐户。 有关详细信息,请参阅“关于 GitHub Codespaces 的计费”。

从 VS Code 发布

如果你使用的是 codespace,可以从 VS Code Web 客户端或桌面应用程序发布它。

  1. 在活动栏中,单击“源代码管理”视图。

    屏幕截图显示 VS Code 活动栏,其中“源代码管理”按钮以橙色边框突出显示。

  2. 若要暂存更改,请单击已添加或更改文件旁边的 +,如果你更改了多个文件并希望全部暂存,请单击“更改”旁边的按钮 。

    “源代码管理”侧栏的屏幕截图,其中位于“更改”右侧的暂存按钮(加号)用深橙色边框突出显示。

    注意: 如果从 GitHub 的空白模板开始,则不会看到更改列表,除非已将目录初始化为 Git 存储库。 若要发布从空白模板创建的 codespace,请在“源代码管理”视图中单击“发布到 GitHub”,然后跳到步骤 5。

  3. 若要提交暂存更改,请键入描述所做更改的提交消息,然后单击“提交”。

    “源代码管理”侧栏的屏幕截图,其中提交消息及其下方的“提交”按钮用深橙色边框突出显示。

  4. 单击“发布分支”。

    “源代码管理”侧栏的屏幕截图,其中显示了“发布分支”按钮。

  5. 在“存储库名称”下拉列表中,键入新存储库的名称,然后选择“发布到 GitHub 专用存储库”或“发布到 GitHub 公共存储库”。

    VS Code 中“存储库名称”下拉列表的屏幕截图。 显示了两个选项,用于发布到专用或公共存储库。

    新存储库的所有者将是创建 codespace 时所使用的 GitHub 帐户。

  6. (可选)在编辑器右下角显示的弹出窗口中,单击“在 GitHub 上打开”,查看 GitHub.com 上的新存储库。

    成功发布存储库的确认消息的屏幕截图,其中显示了“在 GitHub 上打开”按钮。

发布 codespace 后,你可以使用更多选项来自定义 GitHub Codespaces 体验。 例如,你能够:

从 GitHub.com

发布

可以从 GitHub.com 上“你的 codespaces”页面中发布未发布的 codespace。 如果要发布当前未在浏览器中打开的 codespace,此做法非常有用。 如果执行此操作,你的工作将保留在存储库中,但现有 codespace 和新存储库之间不会有链接。 但是,你可以导航到新存储库并从那里创建 codespace,并且此 codespace 将连接到存储库。

  1. 导航到 github.com/codespaces 上的“你的 codespace”页面。

  2. 在未发布的 codespace 旁边,单击省略号 (...) ,然后选择“发布到新存储库” 。

    codespace 下拉菜单的屏幕截图,其中显示了“发布到新存储库”选项。

  3. 为新存储库选择一个名称,将其设置为“公共”或“专用”,然后单击“创建存储库” 。

    “发布到新存储库”下拉列表的屏幕截图,其中包含“名称”字段、“公共”和“专用”选项以及“创建存储库”按钮。

  4. (可选)若要查看新存储库,请单击“查看存储库”。

延伸阅读