git工程化实践：commit规范、emoji、多账号与分支规范

前言

单人项目里 git 怎么提交都行，团队协作时就需要约定：commit 怎么写、分支怎么建、一台机器上公司账号和个人账号怎么共存。这篇把这几件事一次说清。

一、commit message 规范

commit 一共由五部分组成：

（1）type：提交类型

• feat: 新功能
• fix: 修复问题
• docs: 修改文档
• style: 修改代码格式，不影响代码逻辑
• refactor: 重构代码，理论上不影响现有功能
• perf: 提升性能
• test: 增加修改测试用例
• chore: 修改工具相关（包括但不限于文档、代码生成等）
• deps: 升级依赖

（2）scope：修改文件的范围（包括但不限于 doc、middleware、core、config、plugin）。

（3）subject：用一句话清楚的描述这次提交做了什么。

（4）body：补充 subject，适当增加原因、目的等相关因素，也可不写。

（5）footer：

• 当有非兼容修改（Breaking Change）时必须在这里描述清楚
• 关联相关 issue，如 Closes #1, Closes #2, #3
• 如果功能点有新增或修改的，还需要关联文档 doc

二、emoji 规范

以下 emoji 在 git 提交时已经完全支持，直接在 commit message 里使用即可：

组合示例：

1
2

git commit -m ":sparkles: (order) 新增订单导出功能"
git commit -m ":bug: (pay) 修复支付回调重复入账问题 Closes #1024"

三、同机多账号管理

工作和个人项目共存一台机器时，为每个平台生成独立的 ssh key：

1. 生成 ssh key

1
2
3
4
5
6

# 通用格式
ssh-keygen -t rsa -b 4096 -C "your_email@example.com" -f ~/.ssh/<平台名称>_id_rsa

# 示例：GitHub 一把、GitCode 一把
ssh-keygen -t rsa -b 4096 -C "your_email@example.com" -f ~/.ssh/github_id_rsa
ssh-keygen -t rsa -b 4096 -C "your_email@example.com" -f ~/.ssh/gitcode_id_rsa

~/.ssh/ 目录可以看到生成的密钥文件：私钥 xxx_id_rsa（不公开）、公钥 xxx_id_rsa.pub（添加到对应平台）。

2. 配置 ~/.ssh/config

# ------------------------ GitHub 配置 ------------------------
Host github.com
  HostName github.com          # 实际主机名（不变）
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/github_id_rsa  # 指向GitHub私钥

# ------------------------ GitCode 配置 ------------------------
Host gitcode.com
  HostName gitcode.com
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/gitcode_id_rsa  # 指向GitCode私钥

再配合每个仓库单独设置提交身份，即可完全隔离：

1
2

git config user.name "work-name"
git config user.email "work@example.com"

四、分支规范

在此基础上可以按团队需要扩展：功能分支 feature/xxx、修复分支 hotfix/xxx、发布分支 release/x.y，命名保持 类型/简述 的统一风格即可。

总结

规范的价值在于可追溯：type + emoji 让 git log 一眼可读，scope 让改动范围可定位，分支规范让环境对应关系清晰。工具层面可以再配合 commitlint + husky 做强制校验，把约定变成流程。