如何在Git分支发布代码构建/版本？Bitbucket发布方案咨询

首先明确结论：你考虑的Stable分支承载发布文件的方案，在你给出的「单版本二进制仅5MB、全仓库总大小100MB、你是仓库唯一开发者」这几个前提下完全可用，没有本质问题，现阶段没必要额外折腾外部存储。
很多开发者不推荐用Git存二进制，核心原因是大体积二进制频繁迭代会快速撑大仓库体积、拖慢克隆拉取速度，你的场景完全踩不到这个坑：就算后续迭代20个版本，累积的二进制总大小也就100MB上下，和普通全量代码仓库体积差不多，维护成本远低于对接外部存储。如果后续你能开通Bitbucket自带的Downloads功能，优先用官方功能就行，当前没开通的话用分支完全够用。

• 初始化分支不要从主开发分支直接切：直接创建孤立分支最干净，执行命令git checkout --orphan Stable，切完之后运行git rm -rf .清空当前工作区的所有开发相关文件，只放2个待发布的可执行文件、一份面向用户的简易说明文档即可。这个分支不需要配置.gitignore——分支里本来就只存你主动放的发布产物，不会出现构建缓存、开发依赖这类需要忽略的文件，加了反而多余。
• 版本更新不要用合并操作：每次主分支完成版本开发、编译出正式可执行文件后，切到Stable分支，直接把旧版本的2个可执行文件替换成新版本的文件再提交即可，绝对不要执行git merge把开发分支合并进来——合并操作会把所有开发代码、提交历史全部带到Stable分支，违背你做这个分支的初衷。提交信息直接写清楚对应版本号就行，比如Publish v1.0.0 stable build，不需要带开发过程的杂乱记录。
• 标签直接打在Stable分支的发布提交上：每次提交完新版本的发布文件，直接给当前提交打对应版本的标签，比如v1.0.0、v1.1.2，不需要和开发分支的标签做关联。用户需要下载历史版本时，直接切换到对应标签就能拿到对应版本的文件，不用翻找提交历史。
• 用户侧不需要克隆全仓库：Bitbucket本身支持单文件直接下载，你直接把Stable分支下最新版可执行文件的页面链接发给用户即可，用户点进去就能直接下文件，不用拉取整个仓库的内容。

• Stable分支只做发布用，不要在上面改代码、提交测试构建产物，所有开发动作全部在主开发分支完成，保证这个分支的每一次提交都对应一个可正常使用的正式版本。
• 每次提交新版本时，可以在提交说明里附上两个可执行文件的SHA256校验值，方便用户下载完校验文件完整性，不用额外单独放校验文件。
• 后续如果仓库开通了Bitbucket Downloads功能，直接把Stable分支里存的历史版本二进制同步过去就行，迁移成本极低，现阶段不用提前做适配。

内容的提问来源于stack exchange，提问作者Zara