DAG总览 / 组目录 / 版本管理

发布(Release)

G02Layer 4
目录:前置概念账号与仓库版本管理协作项目管理自动化部署工具生态
层导航:L0L1L2L3L4 当前L5L6L7L8
上游 · 理解本功能前需先掌握的(1):
下游 · 依赖/承接本功能的(0):
暂无下游(建议学完它再进阶)
前置依赖包含从属概念升级流程承接 边方向 = 学习顺序(A→B 表示先学 A 再学 B)

为什么需要它

心智模型

你的项目写好了,怎么让别人方便地下载某个稳定版本?发布(release)就是答案:它把某个版本的代码打包成可下载的交付物,并附上说明。对新手来说,这是'我的项目完成一个里程碑'时该做的事。

历史背景 · 它为什么诞生诞生于 2013
诞生2013年7月2日GitHub宣布Releases:为交付最终用户提供一等公民工作流,含变更日志与二进制附件,遵循Git惯例绑定到Git tag,展示超越Git工件的完整项目历史。

功能介绍

官方定义:发布(release)是'可部署的软件迭代,你可以打包并向更广泛的受众提供下载'。发布基于 Git 标签(tag)创建:选定一个标签(或新建标签)后,GitHub 会自动生成该版本代码的 zip 与 tarball(一种压缩包格式)供人下载,你也可以额外上传二进制安装包等附件。每个发布还支持写发布说明(release notes),介绍这个版本新增了什么、修了什么 bug。发布之后,用户订阅了 Release 通知就能第一时间收到更新提醒。总之:标签负责'标记版本',发布负责'交付版本',二者配合形成完整的产品发布闭环。

核心术语

发布(release):打包并向用户交付的软件版本标签(tag):发布所锚定的提交标记tarball:GitHub 自动生成的 .tar.gz 源码压缩包发布说明(release notes):版本更新内容的说明文字可部署(deployable):可投入实际使用的状态

适用场景

怎么操作(网页 vs 命令行 双轨)

🖱️ 网页操作 (GitHub.com)
  • 在仓库 'Releases' 页面点击 'Create a new release'
  • 输入标签版本号(可新建)与标题、填写发布说明
  • 按需上传二进制附件,点击 'Publish release' 完成发布
  • 用户即可在 Releases 页面看到版本与自动生成的 zip/tarball 下载链接
⌨️ 命令行 (进阶)
  • git tag -a v1.0.0 -m "v1.0.0 发布" # 先为版本打标签
  • git push origin v1.0.0 # 推送标签到远程
  • gh release create v1.0.0 --notes "首个稳定版" # 用 GitHub CLI 创建发布

新手建议先从网页操作入手,熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。

与其他功能的关系

关系(前置依赖 / 包含从属 / 概念升级 / 流程承接)说明
前置依赖标签(Tag)Release 基于 Git tag 打包发布物

官方文档

小结

SUMMARY

发布基于标签把版本打包成可下载交付物,配发布说明和附件,是产品里程碑的'成品展柜'。打标签、发发布,你的项目就真正'对外可用'了。下一步:学会用 push 和 pull 同步本地与云端。