Git 使用技巧与最佳实践

1
2
3

# 全局配置使用者信息，用于提交工作时展示个人信息
git config --global user.name "ideal"
git config --global user.email "example@ideal.com"

1

git init

1
2
3
4
5
6
7
8

# 生成 SSH 密钥
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

# HTTPS 方式克隆
git clone https://github.com/wx-coding/git-test.git

# SSH 方式克隆
git clone git@github.com:wx-coding/git-test.git

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

wx@wxdeMacBook-Pro git-test % git status

On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
    new file:   a.txt

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
    modified:   .gitignore
    modified:   a.txt

1
2
3
4
5
6
7
8

# 添加一个指定文件至暂存区
git add 文件名

# 添加所有修改文件至暂存区
git add .

# 取消文件加入暂存区
git restore --staged 文件名

1

git commit -m "提交说明"

1
2
3
4
5
6
7

# 修改最近一次提交信息
git commit --amend -m "..."

# 推送修改后的提交
# --force-with-lease：比 --force 更安全，只有本地分支与远程分支匹配时才会强制推送
git push origin main --force-with-lease
# --force：直接覆盖远程提交，不推荐用于多人协作的分支

1
2
3
4

git log

# 简洁日志
git log --oneline --graph --decorate --all

1
2
3
4
5
6
7
8

# 推送并设置推送到哪一个分支
git push -u origin <branch_name>

# 直接推送
git push

# 拉取远程某一分支
git pull origin branch_name

1
2
3
4
5
6
7
8

# 查看本地分支，当前分支有星号（*）
git branch

# 查看所有分支，包括远程分支
git branch -a

# 查看远程分支所有信息
git fetch --all

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 在当前提交的基础上创建一个新分支
git branch branch_name

# 创建并切换到新分支
git checkout -b branch_name

# 重命名分支
git branch -m new_branch_name

# 查看分支详细信息
git branch -vv

1
2
3
4
5
6

# 切换分支
git checkout branch_name
git switch branch_name

# 在本地创建分支并拉取远程分支
git checkout -b 本地分支名 origin/远程分支名

1
2
3
4
5
6
7

# 切换到主分支，将 branch_name 合并至主分支
git merge branch_name
# 如有冲突，手动解决冲突
# 解决冲突后继续提交

# 使用 rebase 合并
git rebase branch_name

1
2
3
4
5
6
7
8

# 删除本地分支
git branch -d branch_name

# 强制删除本地分支
git branch -D branch_name

# 删除远程分支
git push origin --delete branch_name

1
2
3
4
5

# 查看两个分支之间的差异
git diff branch_name_a branch_name_b

# 查看分支日志差异
git log branch_name_a..branch_name_b

1

git checkout <目标版本号>

1
2

# 本地回滚但保留代码
git reset --soft <目标版本号>

1
2

# 本地回滚并清除暂存区
git reset --mixed <目标版本号>

1
2

# 彻底回滚（删除提交）
git reset --hard <目标版本号>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 先本地回滚
git reset --hard <目标版本号>

# 强制推送（会覆盖远程历史，可能导致团队成员的代码不同步，慎用！）
git push origin --force

# 推荐使用 --force-with-lease，以避免意外覆盖其他人的提交
git push origin --force-with-lease

# 不会删除历史，而是创建一个新的提交来撤销目标版本之后的更改
git revert <目标版本号>

1

git log --since="2025-01-01" --until="2025-03-01" --pretty=oneline | wc -l

1

git log --since="2025-01-01" --until="2025-03-01" --numstat

1

git log --since="2025-01-01" --until="2025-03-01" --pretty=format:"%s" | grep -E "^(feat|fix|docs|chore|style|refactor|test)" | sort | uniq -c

1
2
3
4
5

git log --since="2025-01-01" --until="2025-03-01" --pretty=format:"%s" | \
  grep -Eo "^(feat|fix|docs|chore|style|refactor|test)" | \
  sort | \
  uniq -c | \
  sort -nr

1
2
3
4
5
6
7
8

# 标准工作流程
git stash              # 保存当前工作
git pull              # 拉取最新代码
git stash pop         # 恢复保存的工作
# 解决冲突...
git add .
git commit -m "resolve conflicts"
git push

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

# 保存当前工作（包括暂存区和工作区）
git stash

# 保存工作并添加描述
git stash save "临时保存：修复登录bug"

# 查看所有 stash 列表
git stash list

# 应用最近的 stash（不删除）
git stash apply

# 应用并删除最近的 stash
git stash pop

# 应用指定的 stash
git stash apply stash@{1}

# 删除指定 stash
git stash drop stash@{0}

# 清空所有 stash
git stash clear

1
2
3
4
5
6
7
8
9

# 好的提交示例
git commit -m "feat: 添加用户邮箱验证功能"
git commit -m "fix: 修复登录页面样式错乱问题"
git commit -m "docs: 更新API文档中的认证部分"

# 避免的提交示例
git commit -m "修改了一些东西"
git commit -m "bug fix"
git commit -m "代码更新"

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

# 开发新功能的完整流程
git checkout main                    # 切换到主分支
git pull origin main                 # 拉取最新代码
git checkout -b feature/user-profile # 创建功能分支
# ... 开发代码 ...
git add .
git commit -m "feat: 完成用户资料页面"
git push -u origin feature/user-profile
# 创建Pull Request进行代码审查
# 审查通过后合并到main分支
git checkout main
git pull origin main
git branch -d feature/user-profile   # 删除本地分支

1
2
3
4
5
6
7

# 方法一：使用 stash
git stash                           # 保存当前工作
git checkout -b correct-branch      # 创建正确的分支
git stash pop                       # 恢复工作

# 方法二：创建分支（如果还没有提交）
git checkout -b correct-branch      # 直接在当前状态创建新分支

1
2
3
4
5
6
7
8

# 将最后一次提交移到正确的分支
git log --oneline -5                # 查看最近的提交
git reset HEAD~1                    # 撤销最后一次提交但保留更改
git stash                           # 保存更改
git checkout correct-branch         # 切换到正确分支
git stash pop                       # 恢复更改
git add .
git commit -m "移动到正确分支的提交"

1
2
3
4
5

# 当出现合并冲突时
git status                          # 查看冲突文件
# 手动编辑冲突文件，解决 <<<<<<< ======= >>>>>>> 标记
git add .                           # 标记冲突已解决
git commit                          # 完成合并

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

# 设置常用别名
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.log1 "log --oneline --graph --decorate --all"

# 设置默认编辑器
git config --global core.editor "code --wait"

# 设置默认分支名
git config --global init.defaultBranch main

# 启用颜色输出
git config --global color.ui auto

# 设置换行符处理（Windows用户）
git config --global core.autocrlf true