Git工作流完全指南：从入门到精通的版本控制实践

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 初始化新仓库
git init my-project
cd my-project

# 克隆现有仓库
git clone https://github.com/user/repo.git
git clone git@github.com:user/repo.git  # SSH方式

# 查看仓库状态
git status

# 查看配置信息
git config --list

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 工作目录 → 暂存区
git add file.txt              # 添加单个文件
git add .                     # 添加所有文件
git add *.js                  # 添加特定类型文件
git add src/                  # 添加目录
git add -p                    # 交互式添加（部分文件）

# 暂存区 → 本地仓库
git commit -m "提交信息"
git commit -am "提交信息"      # 添加并提交已跟踪文件

# 查看差异
git diff                      # 工作目录 vs 暂存区
git diff --cached             # 暂存区 vs 本地仓库
git diff HEAD                 # 工作目录 vs 本地仓库

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

# 主分支
# master - 生产环境代码
# develop - 开发环境代码

# 功能分支
git checkout develop
git pull origin develop
git checkout -b feature/user-authentication

# 完成功能开发
git add .
git commit -m "feat: 实现用户认证功能"

# 合并到develop分支
git checkout develop
git merge --no-ff feature/user-authentication
git branch -d feature/user-authentication

# 推送远程仓库
git push origin develop

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 简化的工作流
# main - 主分支
# feature/* - 功能分支

# 创建功能分支
git checkout main
git pull origin main
git checkout -b feature/payment-system

# 开发并推送
git add .
git commit -m "feat: 添加支付功能"
git push origin feature/payment-system

# 创建Pull Request
# 代码审查通过后合并到main

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 环境分支策略
# main ← develop ← feature/*
#        ← production

# 创建功能分支
git checkout -b feature/dashboard-chart main
git push -u origin feature/dashboard-chart

# 创建Merge Request到main分支
# 审查通过后自动部署到staging环境

# 手动部署到production环境
git checkout production
git merge --no-ff main
git push origin production

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

# 提交信息格式
# <type>[optional scope]: <description>

# 功能性提交
git commit -m "feat(auth): 添加用户登录功能"
git commit -m "feat(api): 新增用户数据接口"

# 修复性提交
git commit -m "fix: 修复登录页面响应式布局问题"
git commit -m "fix(api): 修复用户查询接口的空指针异常"

# 文档提交
git commit -m "docs: 更新API文档"
git commit -m "docs(readme): 添加安装说明"

# 样式提交
git commit -m "style: 格式化代码"
git commit -m "style: 调整按钮颜色"

# 重构提交
git commit -m "refactor: 重构用户服务类"
git commit -m "refactor(utils): 提取通用工具函数"

# 性能优化
git commit -m "perf: 优化数据库查询性能"
git commit -m "perf: 减少首页加载时间"

# 测试提交
git commit -m "test: 添加用户服务单元测试"
git commit -m "test: 修复测试用例"

# 构建相关
git commit -m "build: 更新依赖版本"
git commit -m "build: 添加生产环境构建配置"

# 回滚提交
git commit -m "revert: 回滚用户认证功能"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 配置提交模板
git config --global commit.template ~/.gitmessage.txt

# ~/.gitmessage.txt 内容示例
# 功能描述 (50字符以内)
#

# 详细描述 (为什么做这个改动，解决了什么问题)
#

# 相关Issue: #123
# 影响范围: auth, api
# 测试情况: 已添加单元测试

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 创建新分支
git branch feature/new-feature
git checkout feature/new-feature
# 或者一步完成
git checkout -b feature/new-feature

# 从远程分支创建本地分支
git checkout -b local-branch origin/remote-branch

# 查看所有分支
git branch                    # 本地分支
git branch -r                 # 远程分支
git branch -a                 # 所有分支

# 查看分支最后提交
git branch -v

# 重命名分支
git branch -m old-name new-name

# 删除分支
git branch -d branch-name     # 安全删除（已合并）
git branch -D branch-name     # 强制删除

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 普通合并
git checkout main
git merge feature-branch

# 快进合并（无冲突时）
git merge --ff-only feature-branch

# 非快进合并（保留合并历史）
git merge --no-ff feature-branch

# 压缩合并（将多个提交压缩为一个）
git merge --squash feature-branch

# 变基合并
git checkout feature-branch
git rebase main

# 交互式变基
git rebase -i HEAD~3

# 变基示例：整理提交历史
# pick 1234567 feat: 实现功能A
# squash 2345678 fix: 修复功能A的bug
# squash 3456789 style: 格式化功能A代码
# pick 4567890 feat: 实现功能B

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

# 查看远程仓库
git remote -v

# 添加远程仓库
git remote add origin https://github.com/user/repo.git

# 推送分支到远程
git push origin main
git push origin feature-branch
git push -u origin feature-branch  # 设置上游分支

# 拉取远程更新
git fetch origin                  # 获取远程更新（不合并）
git pull origin main              # 拉取并合并

# 从远程获取特定分支
git checkout -b local-branch origin/remote-branch

# 删除远程分支
git push origin --delete branch-name
git push origin :branch-name       # 简写形式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 创建标签
git tag v1.0.0
git tag -a v1.0.0 -m "版本1.0.0发布"

# 推送标签
git push origin v1.0.0
git push origin --tags           # 推送所有标签

# 删除标签
git tag -d v1.0.0                # 删除本地标签
git push origin --delete v1.0.0  # 删除远程标签

# 查看标签信息
git show v1.0.0
git tag -n                       # 显示标签和注释

1
2
3
4
5
6
7
8
9

# 合并冲突
git merge feature-branch
Auto-merging file.txt
CONFLICT (content): Merge conflict in file.txt
Automatic merge failed; fix conflicts and then commit the result.

# 变基冲突
git rebase main
error: could not apply 1234567... commit message

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# 1. 查看冲突文件
git status

# 2. 编辑冲突文件
# 冲突标记示例：
# <<<<<<< HEAD
# 当前分支的内容
# =======
# 合并分支的内容
# >>>>>>> feature-branch

# 3. 手动解决冲突
# 删除冲突标记，保留正确内容

# 4. 标记冲突已解决
git add conflicted-file.txt

# 5. 继续合并或变基
# 合并冲突
git commit

# 变基冲突
git rebase --continue

# 放弃变基
git rebase --abort

# 查看冲突差异
git diff --name-only --diff-filter=U

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 使用合并工具
git mergetool

# 配置合并工具
git config --global merge.tool vscode
git config --global mergetool.vscode.cmd 'code --wait $MERGED'

# 三路合并比较
git diff --ours file.txt      # 查看当前分支版本
git diff --theirs file.txt     # 查看合并分支版本
git diff --base file.txt       # 查看共同祖先版本

1
2
3
4
5
6
7

# 功能开发完成后
git checkout -b feature/new-feature main
# ... 开发工作 ...
git push origin feature/new-feature

# 在GitHub/GitLab上创建PR
# 填写PR模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

## 变更描述
简要描述本次变更的内容和目的

## 变更类型
- [ ] 新功能 (feature)
- [ ] 修复 (fix)
- [ ] 文档 (docs)
- [ ] 样式 (style)
- [ ] 重构 (refactor)
- [ ] 性能优化 (perf)
- [ ] 测试 (test)

## 测试
- [ ] 单元测试通过
- [ ] 集成测试通过
- [ ] 手动测试完成

## 检查清单
- [ ] 代码符合项目规范
- [ ] 已更新相关文档
- [ ] 无安全漏洞
- [ ] 性能影响评估

## 相关Issue
Closes #123

## 截图（如适用）
<!-- 添加相关截图 -->

## 补充说明
<!-- 其他需要说明的内容 -->

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 查看PR变更
git fetch origin pull/123/head:pr-123
git checkout pr-123

# 查看差异
git diff main...pr-123
git diff --stat main...pr-123

# 查看特定文件的变更历史
git log -p main..pr-123 -- file.txt

# 使用工具进行代码审查
# GitHub/GitLab的Web界面
# 命令行工具：gh pr view, lab mr show

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 撤销工作目录的修改
git checkout -- file.txt       # 撤销单个文件
git checkout -- .               # 撤销所有文件

# 撤销暂存区的修改
git reset HEAD file.txt         # 从暂存区移除
git reset HEAD                  # 移除所有暂存文件

# 清理未跟踪的文件
git clean -fd                   # 删除未跟踪的文件和目录
git clean -nfd                  # 预览将要删除的文件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 软回滚（保留修改，撤销提交）
git reset --soft HEAD~1

# 混合回滚（撤销提交和暂存，保留工作目录）
git reset --mixed HEAD~1
git reset HEAD~1               # 默认行为

# 硬回滚（撤销所有修改，回到指定提交）
git reset --hard HEAD~1

# 创建反向提交（推荐用于公共分支）
git revert HEAD                # 创建撤销上次提交的新提交

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 查看操作历史
git reflog

# 恢复丢失的提交
git reset --hard HEAD@{2}
git checkout -b recover-branch HEAD@{2}

# 查找特定提交
git log --grep="关键词"
git log --author="作者名"
git log --since="2024-01-01"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# 查看可用hooks
ls .git/hooks/

# 启用pre-commit hook（示例：代码格式检查）
#!/bin/sh
# .git/hooks/pre-commit

npm run lint
if [ $? -ne 0 ]; then
    echo "代码格式检查失败，请修复后再提交"
    exit 1
fi

echo "代码格式检查通过"
exit 0

# 设置执行权限
chmod +x .git/hooks/pre-commit

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# 添加子模块
git submodule add https://github.com/user/repo.git path/to/submodule

# 克隆包含子模块的仓库
git clone --recursive https://github.com/user/main-repo.git
# 或者
git clone https://github.com/user/main-repo.git
cd main-repo
git submodule init
git submodule update

# 更新子模块
git submodule update --remote

# 删除子模块
git submodule deinit path/to/submodule
git rm path/to/submodule
git commit -m "移除子模块"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# 暂存当前工作
git stash
git stash push -m "工作描述"

# 查看暂存列表
git stash list

# 应用暂存
git stash apply
git stash apply stash@{1}

# 应用并删除暂存
git stash pop

# 删除暂存
git stash drop
git stash clear

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 配置常用别名
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.st status
git config --global alias.unstage 'reset HEAD --'
git config --global alias.last 'log -1 HEAD'
git config --global alias.visual '!gitk'
git config --global alias.graph 'log --oneline --graph --decorate --all'
git config --global alias.amend 'commit --amend'
git config --global alias.undo 'reset --soft HEAD~1'

# 查看所有别名
git config --global --get-regexp alias

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 使用Git LFS（Large File Storage）
# 安装Git LFS
git lfs install

# 跟踪大文件
git lfs track "*.zip"
git lfs track "*.pdf"
git lfs track "*.mov"

# 查看LFS跟踪的文件
git lfs ls-files

# Git LFS配置
cat .gitattributes
# *.zip filter=lfs diff=lfs merge=lfs -text
# *.pdf filter=lfs diff=lfs merge=lfs -text

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 垃圾回收
git gc

# 压缩仓库历史
git gc --aggressive

# 清理不必要的文件
git prune

# 移除大文件历史
git filter-branch --tree-filter 'rm -rf large-file.zip' HEAD

# 使用BFG Repo-Cleaner（更高效）
# java -jar bfg.jar --delete-files large-file.zip my-repo.git

1
2
3
4
5
6
7
8

# 浅克隆（只获取最新提交）
git clone --depth 1 https://github.com/user/repo.git

# 部分克隆（只克隆特定目录）
git clone --filter=blob:none --sparse https://github.com/user/repo.git
cd repo
git sparse-checkout init --cone
git sparse-checkout set src/main

1
2
3
4
5
6
7
8

# 小团队推荐：GitHub Flow
# main + feature/* 分支

# 中等团队推荐：Git Flow
# master + develop + feature/* + release/* + hotfix/*

# 大型团队推荐：GitLab Flow
# main + develop + environment/* + feature/*

1
2
3
4
5
6
7
8
9

# 使用commitizen工具规范化提交
npm install -g commitizen
git cz  # 交互式提交

# 使用husky自动检查
npm install husky --save-dev
npx husky install
npx husky add .husky/commit-msg 'npx commitlint --edit $1'
npx husky add .husky/pre-commit 'npm test'

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# .github/workflows/ci.yml
name: CI

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3

    - name: Setup Node.js
      uses: actions/setup-node@v3
      with:
        node-version: '18'

    - name: Install dependencies
      run: npm ci

    - name: Run tests
      run: npm test

    - name: Run linting
      run: npm run lint

    - name: Check commit messages
      run: npx commitlint --from=origin/main --to HEAD