🔧 【用途定位】
- 解决什么问题?规范代码版本管理流程,保障生产环境代码安全、可追溯与平滑部署。
- 适用场景:个人/团队软件开发、版本发布管理、敏感凭证隔离、CI/CD 流水线对接。
- 关键名词:
Git、main分支、dev分支、feature分支、.env、.gitignore、Tag 标记。
📋 【核心方法】
- 版本固化:在稳定版本执行
git tag v0.1.0并推送远程git push origin v0.1.0,确保历史快照永久可回溯。 - 分支策略:
main仅存放已验证的生产代码;日常开发在dev分支进行;长周期/大改动(如付费体系)独立创建feature/xxx分支,测试通过后合并回main。 - 提交规范:涉及核心业务逻辑(如支付接入、回调验证)需按功能点拆分多次
commit,避免大段混改导致问题难以定位。 - 敏感信息管理:新建
.env文件存储 API 密钥等变量,在.gitignore中屏蔽该文件,同时维护.env.example作为配置模板留存。 - 上线节奏:新功能在
dev/feature分支开发 → 稳定后合入main→main每次更新触发部署 → 重要节点打 Tag 归档。
⚠️ 【避坑指南】
- 严禁将
.env或包含私钥/Token 的文件直接提交至仓库,否则会导致严重安全事故。 main分支必须保持随时可部署状态,禁止直接在main上进行未经测试的修改。- 资金相关逻辑的 Commit 粒度要细,合并冲突排查成本会随代码量指数级上升。