Git 应用与规范指南

一、Git 基础概念

Git 是一个分布式版本控制系统，用于跟踪代码变更、管理项目版本和支持团队协作。

1. 核心概念

• 仓库（Repository）：包含项目所有文件和历史记录的目录
• 提交（Commit）：记录文件的一组更改，包含作者、时间戳和提交信息
• 分支（Branch）：独立的代码开发线路，允许并行开发
• 合并（Merge）：将一个分支的更改整合到另一个分支
• 远程仓库（Remote）：托管在网络上的仓库副本
• 工作区（Working Directory）：本地正在编辑的文件
• 暂存区（Staging Area）：准备提交的文件更改集合
• HEAD：指向当前检出分支的最新提交

2. 安装与配置

# 安装完成后配置用户信息
git config --global user.name "Your Name"
git config --global user.email "[e-mail]"# 配置默认编辑器
git config --global core.editor "code --wait"  # 使用VS Code# 查看配置
git config --list

二、Git 常用命令

1. 基础操作命令

# 初始化新仓库（在当前目录初始化一个新的Git仓库）
git init# 克隆现有仓库
git clone <repository-url>
# 示例：克隆一个GitHub仓库
git clone https://github.com/username/project.git# 查看文件状态（检查当前工作区的文件状态）
git status# 添加文件到暂存区
git add <file>         # 添加单个文件
git add .              # 添加所有更改的文件
# 示例：添加单个文件
git add index.html
# 示例：添加所有修改的文件
git add .# 提交更改
git commit -m "提交信息"
# 示例：提交带有描述信息的更改
git commit -m "feat: add login page"# 查看提交历史
git log                # 查看完整的提交历史
git log --oneline      # 简洁格式查看提交历史# 推送更改到远程仓库
git push origin <branch-name>
# 示例：将本地main分支推送到远程
git push origin main# 拉取远程更改
git pull origin <branch-name>
# 示例：拉取远程develop分支的最新更改
git pull origin develop# 获取远程仓库信息 （查看当前配置的远程仓库）
git remote -v

2. 分支操作命令

# 查看所有分支
git branch
# 查看所有分支（包括远程分支）
git branch -a# 创建新分支
git branch <branch-name>
# 示例：创建一个名为feature/login的新分支
git branch feature/login# 切换分支
git checkout <branch-name>
# 示例：切换到develop分支
git checkout develop# 创建并切换到新分支
git checkout -b <branch-name>
# 示例：创建并切换到feature/profile分支
git checkout -b feature/profile# 合并分支
git merge <branch-name>  # 将指定分支合并到当前分支
# 示例：将feature/login分支合并到当前分支
git merge feature/login# 删除分支
git branch -d <branch-name>  # 删除已合并的分支
git branch -D <branch-name>  # 强制删除未合并的分支
# 示例：删除已合并的feature/login分支
git branch -d feature/login
# 示例：强制删除未合并的experimental分支
git branch -D experimental# 推送新分支到远程
git push -u origin <branch-name>
# 示例：推送feature/dashboard分支到远程并设置上游跟踪
git push -u origin feature/dashboard

3. 高级操作命令

# 暂存当前更改
git stash
git stash list         # 查看所有暂存
git stash apply        # 应用最近的暂存
git stash drop         # 删除最近的暂存
git stash pop          # 应用并删除最近的暂存
# 示例：暂存当前未提交的更改
git stash
# 示例：查看所有暂存记录
git stash list
# 示例：应用最近的暂存但不删除
git stash apply
# 示例：应用最近的暂存并删除
git stash pop# 撤销工作区更改
git checkout -- <file>
# 示例：撤销对index.html文件的未提交更改
git checkout -- index.html# 撤销暂存区更改
git reset HEAD <file>
# 示例：从暂存区移除app.js文件，但保留工作区更改
git reset HEAD app.js# 回滚提交
git reset <commit-id>  # 软回滚（保留更改）
git reset --hard <commit-id>  # 硬回滚（丢弃更改）
# 示例：软回滚到上一个提交（保留更改）
git reset HEAD^1
# 示例：硬回滚到特定提交（丢弃所有之后的更改）
git reset --hard a1b2c3d# cherry-pick（选择性合并提交）
git cherry-pick <commit-id>
# 示例：将特定提交应用到当前分支
git cherry-pick a1b2c3d# 打标签
git tag <tag-name>     # 为当前提交创建标签
git tag -a <tag-name> -m "标签信息"
git push origin <tag-name>  # 推送标签到远程
# 示例：创建轻量标签
git tag v1.0.0
# 示例：创建带注释的标签
git tag -a v1.0.0 -m "Version 1.0.0 release"
# 示例：推送标签到远程
git push origin v1.0.0

三、Git 分支命名规范

1. 常见分支类型

分支类型	命名格式	示例	说明
主分支	main / master	main	稳定可发布的代码，保护分支，禁止直接提交
开发分支	develop	develop	日常开发主分支，功能完成后合并到此
功能分支	feature/简短描述	feature/user-login	从 develop 创建，完成后合并回 develop
Bug 修复分支	bugfix/简短描述	bugfix/fix-email-validation	修复开发中的问题，从 develop 创建
发布分支	release/版本号	release/1.2.0	准备发布版本，从 develop 创建，完成后合并到 main 和 develop
热修复分支	hotfix/简短描述	hotfix/critical-security-fix	线上紧急修复，从 main 创建，完成后合并到 main 和 develop

2. 命名规范

• 使用短横线 - 分隔单词（如 feature/user-authentication）
• 统一前缀（如 feature/、bugfix/）方便分类和筛选
• 保持简短且描述性强，让人一看就知道用途
• 避免特殊字符（如 #、$、@）和空格
• 使用小写字母，提高可读性
• 关联issue号（如有）：feature/issue-123-user-login

四、Git 分支管理策略

1. Git Flow 工作流

Git Flow 是一种成熟的分支管理工作流，适合中大型项目。

2. 其他常用工作流

• 集中式工作流：类似于SVN，只有一个主分支，适合小型团队
• 功能分支工作流：所有功能开发都在专门的功能分支上进行
• Forking工作流：适用于开源项目，开发者fork仓库后提交Pull Request

五、代码合并与冲突解决

1. 代码合并方法

• Merge合并：保留分支历史，创建新的合并提交

  # 基本合并命令
  git merge <branch-name># 示例：将feature/homepage分支合并到当前分支
  git merge feature/homepage# 示例：合并时创建详细的合并提交信息
  git merge --no-ff feature/homepage
  

• Rebase变基：将当前分支的提交移到目标分支的最新提交之后，使历史更线性

  git checkout <branch-name>
  git rebase develop# 示例：在feature/profile分支上执行变基操作
  git checkout feature/profile
  git rebase develop# 示例：解决变基过程中的冲突后继续变基
  git add .
  git rebase --continue
  

2. 冲突解决步骤

1. 识别冲突：Git会标记冲突文件
2. 查看冲突：打开冲突文件，查找冲突标记 <<<<<<<, =======, >>>>>>>
3. 解决冲突：编辑文件，保留正确内容，删除冲突标记
4. 标记为已解决：git add <conflicted-file>
5. 完成合并：git commit

# 示例：解决冲突后完成合并
# 1. 编辑冲突文件，解决冲突
# 2. 标记为已解决
git add conflicted_file.c
# 3. 完成合并
git commit -m "fix: resolve merge conflict"

<<<<<<< HEAD
// 当前分支的代码
=======
// 合并分支的代码
>>>>>>> branch-name

六、团队协作最佳实践

1. 提交规范

• 提交信息清晰明了：type(scope): subject 格式（如 feat(auth): add user login functionality）
• 保持提交粒度合理：每个提交对应一个独立的更改
• 避免大文件提交：使用 .gitignore 文件排除临时文件、构建产物等

2. 日常工作流程

• 每天开始工作前：git pull origin develop 拉取最新代码
• 开发新功能时：创建专门的功能分支
• 定期同步代码：将 develop 分支的更改合并到功能分支
• 完成功能后：提交Pull Request进行代码审查

3. 代码审查流程

• 使用Pull Request/Merge Request进行代码审查
• 至少1-2名团队成员参与审查
• 审查重点：代码质量、功能实现、潜在问题
• 审查通过后再合并到主分支

七、Git 高级功能

1. Git Hooks

Git Hooks 允许在特定Git事件发生时自动执行脚本。

常用钩子：

• pre-commit：提交前运行（可用于代码格式化、语法检查等）
• commit-msg：检查提交信息格式
• post-commit：提交后运行
• pre-push：推送前运行

示例 .git/hooks/pre-commit 脚本：

#!/bin/sh
# 运行代码格式化
export PATH=$PATH:/usr/local/bin
npx prettier --write .
# 添加格式化后的文件
git add .

示例 .git/hooks/commit-msg 脚本：

#!/bin/sh
# 检查提交信息是否符合规范
COMMIT_MSG_FILE=$1
PATTERN="^feat|fix|docs|style|refactor|test|chore\(.*\): .{1,50}"
if ! grep -qE "$PATTERN" "$COMMIT_MSG_FILE"; thenecho "提交信息不符合规范，请使用: type(scope): subject"exit 1
fi

2. Git 子模块

用于管理项目中的外部依赖。

# 添加子模块
git submodule add <repository-url> <path>
# 示例：添加一个UI组件库作为子模块
git submodule add https://github.com/username/ui-components.git src/components/external# 克隆包含子模块的仓库
git clone <repository-url>
git submodule update --init --recursive
# 示例：克隆包含子模块的仓库并初始化所有子模块
git clone https://github.com/username/main-project.git
git submodule update --init --recursive# 更新子模块
git submodule update --remote
# 示例：更新所有子模块到最新版本
git submodule update --remote --recursive

3. Git blame

查看文件每行代码最后一次修改的提交和作者。

git blame <file>
# 示例：查看index.js文件每行代码的修改记录
git blame index.js
# 示例：只查看index.js文件第10-20行的修改记录
git blame -L 10,20 index.js

八、Git 常见问题解决方案

1. 撤销错误提交

# 撤销最近的提交，但保留更改
git reset --soft HEAD^1
# 示例：撤销最近一次提交，但保留更改以便修改
git reset --soft HEAD^1# 完全撤销最近的提交，丢弃更改
git reset --hard HEAD^1
# 示例：彻底撤销最近一次提交，丢弃所有更改
git reset --hard HEAD^1# 撤销已推送到远程的提交（谨慎使用）
git revert HEAD
# 示例：创建一个新提交来撤销上一次提交的更改
git revert HEAD

2. 找回丢失的提交

git reflog               # 查看所有引用历史
git checkout <commit-id> # 检出丢失的提交
git branch recover-branch # 创建新分支保留该提交
# 示例：查看所有操作历史以找到丢失的提交
git reflog
# 示例：恢复特定的丢失提交
git checkout a1b2c3d
# 示例：创建新分支来保留找回的提交
git branch recovered-feature a1b2c3d

3. 清理未跟踪文件

git clean -n            # 预览将要删除的文件
git clean -f            # 删除未跟踪的文件
git clean -fd           # 删除未跟踪的文件和目录
git clean -fx           # 删除未跟踪的文件和被忽略的文件
# 示例：先预览将要清理的文件
git clean -n
# 示例：清理所有未跟踪的文件
git clean -f
# 示例：清理所有未跟踪的文件和目录
git clean -fd

九、Git 工具推荐

1. 命令行工具

• git-extras：提供额外的Git命令，如git summary、git effort等
• hub：GitHub命令行工具，简化GitHub操作
• git-flow：Git Flow工作流辅助工具，自动化分支管理流程

2. GUI工具

• SourceTree：免费的Git GUI客户端，支持多种Git操作
• GitKraken：直观的Git客户端，支持多种Git托管服务
• GitHub Desktop：GitHub官方客户端，简化GitHub工作流
• VS Code Git集成：轻量级Git操作界面，集成在代码编辑器中

---

希望本指南能帮助你更好地学习和应用Git进行版本控制和团队协作。Git是一个强大的工具，掌握它将大大提高你的开发效率和代码管理能力。

持续学习，不断实践，你会越来越熟练地使用Git！

本博客为个人技术记录与分享平台，内容基于实践经验整理。如有错误或建议，欢迎在评论区指正，将及时核实并修正。