关于适用于 GitHub Codespaces 的模板

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

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

注意

如果你拥有托管用户帐户，则无法使用 GitHub 的 GitHub Codespaces 公共模板，因为你只能创建由组织或企业拥有和付费的 codespace。有关详细信息，请参阅“关于 Enterprise Managed Users”。

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

例如，如果通过 GitHub 的 React 模板创建 codespace，您将进入一个工作区，其中包含用于简单应用程序的模板文件，例如 index.js、app.js 和 package.json。在 codespace 打开后不久，开发服务器将自动启动，并且你将能够在 VS Code Web 客户端内的简单浏览器选项卡中查看正在运行的应用程序。

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

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

提示

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

使用 GitHub 模板创建代码空间

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

在 GitHub 的左上角，选择，然后单击“ Codespaces”，转到 github.com/codespaces 上的“Your codespaces”页面****。1. 若要查看模板的完整列表，请在“浏览快速入门模板”部分，单击“查看全部”。
（可选）若要查看包含模板文件的模板存储库，请单击模板的名称。
在要启动的模板名称下，单击“使用此模板”。

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

通过模板存储库创建代码空间（codespace）

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

在 GitHub 上，导航到存储库的主页面。1. 单击“使用此模板”，然后单击“在 codespace 中打开”。

注意

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

发布到GitHub仓库

数据重用.codespaces.关于发布模板 %}

从 VS Code

发布

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

在活动栏中，单击“源代码管理”视图。
要暂存更改，请单击已添加或更改文件旁边的 +，如果你更改了多个文件并希望全部暂存，请单击“Changes”旁边的按钮********。

注意

如果从 GitHub 的空白模板开始，则不会看到更改列表，除非已将目录初始化为 Git 存储库。若要发布从空白模板创建的 codespace，请在“源代码管理”视图中单击“发布到 GitHub”，然后跳到步骤 5。
若要提交暂存更改，请键入描述所做更改的提交消息，然后单击“提交”。
单击“发布分支”。
在“存储库名称”下拉列表中，键入新存储库的名称，然后选择“发布到 GitHub 专用存储库”或“发布到 GitHub 公共存储库”。

新存储库的所有者将是创建 codespace 时所使用的 GitHub 帐户。
（可选）在编辑器右下角显示的弹出窗口中，单击“在 GitHub 上打开”，查看 GitHub 上的新存储库。

在 codespace 成功发布后，你可以访问更多选项，以自定义 GitHub Codespaces 体验。例如，可以：

更改 codespace 的计算机类型，以确保使用适合你当前所执行工作的资源（请参阅更改代码空间的计算机类型）。
允许 GitHub 自动使用 GPG 对你在 codespace 中的提交进行签名（请参阅管理 GitHub Codespaces 的 GPG 验证）。
与你的 codespace 共享机密信息（请参阅管理 GitHub Codespaces 的账户专属的机密）。

从 GitHub

中发布

可以从 GitHub 上的“您的代码空间”页面发布尚未发布的代码空间。如果要发布当前未在浏览器中打开的 codespace，此做法非常有用。如果执行此操作，你的工作将保留在存储库中，但现有 codespace 和新存储库之间不会有链接。不过，你可以进入新存储库并在那里创建一个 codespace，而这个 codespace 将连接到该存储库。

在 GitHub 的左上角，选择，然后单击“ Codespaces”，转到 github.com/codespaces 上的“Your codespaces”页面****。
在未发布的 codespace 旁边，单击省略号 (...) ，然后选择“发布到新存储库” 。
为新存储库选择一个名称，将其设置为“公共”或“专用”，然后单击“创建存储库” 。
（可选）若要查看新存储库，请单击“查看存储库”。

其他阅读材料

        [AUTOTITLE](/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository)

        [AUTOTITLE](/codespaces/about-codespaces/understanding-the-codespace-lifecycle)

        [AUTOTITLE](/codespaces/developing-in-a-codespace/using-source-control-in-your-codespace)

通过模板创建 codespace

在本文中