中国电信 网站备案北京市住房和城乡建设局官网
Git 使用规范与命令使用场景详解
Git 是现代软件开发中不可或缺的版本控制工具。掌握 Git 的使用规范和命令场景，不仅能提升个人开发效率，还能确保团队协作的顺畅。本文将从 Git 使用规范 和 常用命令场景 两部分进行讲解，帮助你系统性地掌握 Git 的核心用法。
一、Git 使用规范
1. 分支策略（Branch Strategy）
Git 的分支策略是团队协作的核心。以下是常见的分支类型及其使用规范：
| 分支类型 | 命名规则 | 使用场景 |
|---|---|---|
| 主分支 | main 或 master | 用于生产环境部署，仅用于发布版本和打 Tag，不参与开发。 |
| 开发分支 | develop | 日常开发集成分支，所有功能分支合并归此，保持阶段性稳定。 |
| 功能分支 | feature/<模块>-<功能>-<任务ID> | 单个功能开发分支，从 develop 创建，开发完成后合并回 develop。 |
| 修复分支 | bugfix/<模块>-<简要描述> | 非紧急缺陷修复，从 develop 创建，修复后合并回 develop。 |
| 热修复分支 | hotfix/<简要描述> | 生产环境紧急修复，从 main 创建，修复后合并回 main 和 develop。 |
| 发布分支 | release/v<版本号> | 发布前版本封版处理，如补充文档、调整配置等，从 develop 创建。 |
示例：
- 功能分支：
feature/user-login-1234 - 热修复分支：
hotfix/fix-prod-login
2. 提交规范（Commit Message）
规范的提交信息能显著提升代码可维护性。推荐采用 Angular Commit 规范，格式如下：
<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>
提交类型（Type）：
| 类型 | 说明 | 示例 |
|---|---|---|
feat | 新功能开发 | feat(payment): 微信支付功能集成 |
fix | 修复 Bug | fix(auth): 修复登录失败问题 |
docs | 文档更新 | docs: 更新 README.md |
style | 代码格式调整（不影响逻辑） | style: 格式化代码 |
refactor | 代码重构（非功能或 Bug 修复） | refactor(router): 路由模块重构 |
perf | 性能优化 | perf: 优化数据库查询 |
test | 添加或修改测试用例 | test: 新增单元测试 |
chore | 构建工具、依赖项等维护性任务 | chore: 更新依赖包 |
示例：
feat(user): 实现用户注册功能
- 新增注册表单组件
- 添加注册接口调用逻辑
- 完善注册成功后的跳转逻辑
Closes #1234
3. 代码审查与合并规范
- Pull Request (PR)：所有合并到
develop或main的代码必须经过 PR 审查。 - 代码审核要求：
- 确保提交信息符合规范。
- 代码无冗余逻辑。
- 单元测试覆盖率达标。
- 合并方式：
- 优先使用
git merge保留完整历史。 - 仅在需要线性历史时使用
git rebase。
- 优先使用
二、Git 常用命令使用场景
1. 初始化与配置
场景：首次使用 Git 或新项目初始化
# 初始化本地仓库
git init# 克隆远程仓库
git clone <repository-url># 配置用户名和邮箱
git config --global user.name "Your Name"
git config --global user.email "email@example.com"
2. 工作区管理
场景：查看文件状态、添加/提交更改
# 查看工作区文件状态
git status# 将文件添加到暂存区
git add <file-name> # 添加单个文件
git add . # 添加所有更改# 提交更改到本地仓库
git commit -m "提交信息" # 直接提交
git commit -am "提交信息" # 添加并提交（仅限已跟踪文件）
场景：取消暂存或回退更改
# 取消暂存区的更改
git reset <file-name> # 取消单个文件
git reset # 取消所有暂存# 回退到上一个版本（保留工作区更改）
git reset --soft HEAD~1# 彻底回退（删除提交和更改）
git reset --hard HEAD~1
3. 分支操作
场景：创建、切换、合并分支
# 查看本地分支
git branch# 创建新分支
git branch <branch-name># 切换分支
git checkout <branch-name># 合并分支（将 feature 分支合并到当前分支）
git merge feature-branch# 解决冲突后提交
git add . && git commit -m "Merge feature-branch"
场景：变基（Rebase）
# 将当前分支的提交变基到 develop 分支上
git checkout feature-branch
git rebase develop
4. 远程仓库管理
场景：推送、拉取代码
# 推送代码到远程仓库
git push origin <branch-name># 拉取远程仓库更新
git pull origin <branch-name># 关联远程仓库
git remote add origin <repository-url>
场景：强制推送（慎用）
# 强制推送（覆盖远程分支）
git push -f origin <branch-name>
5. 版本回退与恢复
场景：查看提交历史
# 查看提交日志
git log# 图形化查看提交历史
git log --oneline --graph --all# 查看具体文件差异
git diff <file-name>
场景：撤销提交
# 撤销最近一次提交（保留更改）
git reset --soft HEAD~1# 撤销提交并删除更改（慎用）
git reset --hard HEAD~1
场景：恢复误删内容
# 查看所有操作记录（包括被删除的提交）
git reflog# 恢复到指定提交
git checkout <commit-hash>
6. 高级命令场景
场景：精准移植提交（Cherry-pick）
# 将某个提交应用到当前分支
git cherry-pick <commit-hash>
场景：快速定位 Bug（Bisect）
# 启动二分查找
git bisect start
git bisect bad # 标记当前提交为坏版本
git bisect good v1.0 # 标记旧版本为好版本
场景：清理未跟踪文件
# 删除未跟踪文件和目录
git clean -fd
三、总结
Git 的使用规范和命令场景是软件开发中不可或缺的技能。通过遵循分支策略、提交规范和团队协作流程，可以显著提升代码质量和协作效率。同时，灵活运用 Git 命令（如 merge、rebase、cherry-pick 等）能够应对复杂开发场景。
建议：
- 实践为主：多动手尝试 Git 命令，熟悉其行为。
- 规范先行：团队统一 Git 使用规范，减少协作摩擦。
- 善用工具：结合图形化工具（如 VSCode、GitKraken）提升效率。