Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

管理仓库中的发行版

您可以创建要捆绑的发行版,并将项目的迭代交付给用户。

Who can use this feature

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

关于发行版管理

可以使用发行说明、@mentions 参与者和指向二进制文件的链接创建新版本,以及编辑或删除现有发行版。 还可以使用“发布 API”创建、修改和删除发行版。 有关详细信息,请参阅 REST API 文档中的“发行版”。

还可以从 GitHub Marketplace 中的特定发行版发布操作。 有关详细信息,请参阅“在 GitHub Marketplace 中发布操作”。

您可以选择是否将 Git Large File Storage (Git LFS) 对象包含在 GitHub Enterprise Cloud 为每个发行版创建的 ZIP 文件和 tarball 中。 有关详细信息,请参阅“管理存储库存档中的 Git LFS 对象”。

创建发行版

  1. 在 GitHub.com 上,导航到存储库的主页。 1. 在文件列表右侧,单击“发布”。 右侧边栏中的“发布”部分

  2. 单击“草拟新发行版”。

    发行版草稿按钮

  3. 单击“选择标记”,键入发行版的版本号,然后按“输入” 。 或者,选择现有标记。

    输入标记

  4. 如果要创建新标记,请单击“创建新标记”。

    确认要创建新标记的屏幕截图

  5. 如果已创建新标记,请使用下拉菜单选择包含要发布的项目的分支。

    用于选择分支的下拉列表的屏幕截图

  6. (可选)在说明文本框右上角,选择“上一个标记”下拉菜单,然后单击标识上一版本的标记。 显示如何选择标记来标识上一版本的屏幕截图

  7. 键入发行版的标题和说明。 如果 @mention 描述中的任何用户,发布的发行版将包含“参与者”部分以及所有被提及用户的头像列表。 或者,可通过单击“生成发行说明”,以自动生成发行说明 。

    发行说明的屏幕截图

  8. (可选)要在发行版中包含二进制文件(例如已编译的程序),请在二进制文件框中拖放或手动选择文件。

    有关通过发行版提供 DMG 的动画 GIF

  9. 若要通知用户发行版尚未准备投入生产,并且可能不稳定,请选择“这是预发行版”。

    用于将发行版标记为预发行版的复选框的屏幕截图

  10. (可选)可以选择“设置为最新版本”。 如果未选择此选项,系统会根据语义版本控制自动分配最新版本标签。

    用于将版本标记为最新版本的复选框的屏幕截图

  11. (可选)如果 GitHub Discussions 在存储库中启用,请选择“为此发行版创建讨论”,然后选择“类别”下拉菜单,并单击发行版讨论的类别 。

    用于创建发行版讨论和下拉菜单以选择类别的复选框的屏幕截图

  12. 如果已准备好公开发行版,请单击“发布发行版”。 若要稍后处理发行版,请单击“保存草稿”。 “发布发行版”和“草拟发行版”按钮 然后可以在存储库的发行版源中查看发布的或草拟的发行版。 有关详细信息,请参阅“存储库的发行版和标记的屏幕截图”。

    发布的发行版及 @mentioned 参与者

若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。

  1. 若要创建发行版,请使用 gh release create 子命令。 将 tag 替换为发行版所需的标记。

    gh release create TAG
  2. 按照交互式提示进行操作。 或者,您可以指定参数以跳过这些提示。 有关可能的参数的详细信息,请参阅 GitHub CLI 手册。 例如,此命令将创建具有指定标题和注释的预发行版。

    gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a beta release" --prerelease

    如果 @mention 注释中任何 GitHub Enterprise Cloud 用户,则 GitHub.com 上发布的发行版将包含“参与者”部分以及所有被提及用户的头像列表。

编辑发行版

  1. 在 GitHub.com 上,导航到存储库的主页。 1. 在文件列表右侧,单击“发布”。 右侧边栏中的“发布”部分
  2. 在页面右侧要编辑的发行版旁边,单击 编辑发行版
  3. 在窗体中编辑发行版的详细信息,然后单击“更新发行版”。 如果在描述中添加或删除 GitHub 用户的任何 @mentions,则该发行版的“参与者”部分的头像列表中将添加或删除这些用户。 更新发行版

当前无法使用 GitHub CLI 编辑版本。

删除发行版

  1. 在 GitHub.com 上,导航到存储库的主页。 1. 在文件列表右侧,单击“发布”。 右侧边栏中的“发布”部分
  2. 在页面右侧要删除的发行版旁边,单击 删除发行版
  3. 单击“删除此发行版”。 确认删除发行版
  1. 若要删除发行版,请使用 gh release delete 子命令。 将 tag 替换为要删除的发行版标记。 使用 -y 标志跳过确认。

    gh release delete TAG -y