上游 · 理解本功能前需先掌握的(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 同步本地与云端。