Git 日常操作备忘

┌─────────────┐     git add     ┌─────────────┐     git commit    ┌─────────────┐
│  工作区     │ ──────────────→ │  暂存区     │ ───────────────→ │  仓库       │
│  Working    │                 │  Staging    │                  │  Repository │
│  Directory  │ ←────────────── │  Area       │                  │  (.git)     │
└─────────────┘   git restore   └─────────────┘                  └─────────────┘
                        └── git reset --soft  ──────────────────→
                        └── git reset --mixed ────────→

git config --global user.name "Your Name"
git config --global user.email "your@email.com"

git config --global init.defaultBranch main          # 默认分支名从 master → main
git config --global pull.rebase true                 # pull 默认用 rebase 而非 merge
git config --global core.autocrlf input              # 跨平台换行符处理
git config --global core.editor vim                  # 默认编辑器
git config --global credential.helper osxkeychain    # macOS 凭据缓存

git config --list                    # 列出所有配置
git config --global --list           # 只列出用户级
git config user.name                 # 查单项

# 从零开始
git init

# 克隆远程仓库
git clone git@github.com:user/repo.git
git clone https://github.com/user/repo.git

git status                           # 查看当前状态
git add file.txt                     # 暂存单个文件
git add .                            # 暂存所有变更
git commit -m "feat: add login"      # 提交

# 跳过暂存区（仅已跟踪的文件）
git commit -a -m "直接提交所有修改"

# 实用组合
git log --oneline --graph --all --decorate

# 查看某文件的修改历史
git log --oneline -- README.md

# 谁动了哪几行
git blame README.md

git diff                              # 工作区 vs 暂存区
git diff --staged                     # 暂存区 vs 仓库（即将提交的内容）
git diff HEAD                         # 工作区 vs 仓库
git diff branch1..branch2             # 两个分支的差异
git diff commit1..commit2             # 两个提交的差异
git diff --stat                       # 只统计改动的文件

git branch                            # 列出本地分支（* 表示当前分支）
git branch -r                         # 列出远程分支
git branch -a                         # 列出所有分支

git branch feature                    # 创建分支
git checkout feature                  # 切换分支
git checkout -b feature               # 创建并切换（常用）
git switch feature                    # 新版切换（Git 2.23+）
git switch -c feature                 # 新版创建并切换

git branch -d feature                 # 删除分支（已合并）
git branch -D feature                 # 强制删除分支（未合并也删）

# 将 feature 合并到当前分支
git checkout main
git merge feature

# 强制生成 merge commit（即使可以 fast-forward）
git merge --no-ff feature

# 压缩合并
git merge --squash feature
git commit -m "feat: add feature"

git checkout feature
git rebase main        # 将 feature 的提交搬到 main 顶端

# rebase 遇到冲突时
git status                             # 查看冲突
vim conflicted-file                    # 手动解决
git add conflicted-file
git rebase --continue                  # 继续

git rebase --skip                      # 跳过当前提交
git rebase --abort                     # 放弃 rebase，回到之前状态

git rebase -i HEAD~3                   # 修改最近 3 个提交
git rebase -i main                     # 从 main 分支分歧点开始重写

# 常用场景：把多个 wip（work-in-progress）提交合并成一个
pick abc1234 feat: add login page
squash def5678 wip: login form
squash 789abcd wip: login validation

git restore README.md                  # 撤销对 README.md 未暂存的修改
git restore --staged index.html        # 把 index.html 从暂存区移出
git restore --staged --worktree .      # 撤销所有未提交的改动（⚠ 谨慎）

# 只修改提交信息（不改内容）
git commit --amend -m "新的提交信息"

# 添加漏掉的文件到上一次提交
git add forgot-file.txt
git commit --amend --no-edit

# 撤销最近一次提交但保留改动
git reset --soft HEAD~1

# 撤销最近三次提交中的第二次
git revert HEAD~2

git stash                              # 暂存当前改动
git stash list                         # 查看所有 stash
git stash pop                          # 恢复最近的 stash 并删除它
git stash apply                        # 恢复但不删除
git stash drop                         # 删除最近的 stash
git stash apply stash@{2}              # 恢复指定的 stash
git stash -u                           # 也暂存未跟踪的文件

git remote -v                          # 查看远程仓库
git remote add origin git@github.com:user/repo.git
git remote remove origin

# 修改远程地址（换了仓库地址时用）
git remote set-url origin git@github.com:new-user/new-repo.git

git pull                               # 拉取并合并（相当于 git fetch + git merge）
git pull --rebase                      # 拉取并变基（推荐，历史更线性）
git fetch                              # 只拉取，不合并

# 推送本地分支到远程同名分支
git push origin feature

# 本地分支名和远程不同
git push origin local-branch:remote-branch

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

# 本地删除后同步远程分支列表
git remote prune origin

git tag                                   # 列出标签
git tag v1.0.0                            # 创建轻量标签
git tag -a v1.0.0 -m "Release v1.0.0"     # 创建附注标签
git tag -d v1.0.0                          # 删除本地标签

git push origin v1.0.0                    # 推送单个标签
git push origin --tags                    # 推送所有标签
git push origin --delete v1.0.0           # 删除远程标签

# 把某个分支上的特定提交应用到当前分支
git cherry-pick abc1234

# 挑选多个提交
git cherry-pick abc1234 def5678

# 注意：会得到新的 commit hash

# 开始二分查找
git bisect start
git bisect bad                           # 当前版本有 bug
git bisect good v1.0.0                   # v1.0.0 是好的

# Git 会切换到一个中间提交，你测试后：
git bisect good                          # 这个提交没问题
# 或
git bisect bad                           # 这个提交有问题

# 重复几次后 Git 会定位到第一个有问题的提交
git bisect reset                         # 结束后回到原分支

# 自动化
git bisect start HEAD v1.0.0
git bisect run npm test                  # 自动用测试脚本来判断
git bisect reset

git reflog                              # 查看操作历史
git reset --hard HEAD@{2}              # 回到两步前的状态
git checkout abc1234                    # 直接 checkout 被丢弃的提交

git submodule add git@github.com:user/lib.git lib/
git submodule update --init --recursive

# 克隆含子模块的仓库
git clone --recursive git@github.com:user/project.git

main         # 永远可部署
  └─ feat    # 日常开发

feat: add user login page

Implement OAuth2 login flow with GitHub and Google.
Closes #42

# 忽略 Node 项目
node_modules/
dist/
.env

# 忽略系统文件
.DS_Store
Thumbs.db

# 忽略 IDE 配置
.idea/
.vscode/
*.swp

git rm --cached <file>          # 从 Git 中移除但不删文件

# 提交信息写错了
git commit --amend -m "新信息"

# 漏了一个文件
git add forgotten-file.js
git commit --amend --no-edit

# 注意：amend 会生成新的 commit hash，如果已经推送需要用 --force

# 或者用可视化工具
git mergetool

# 第一步：立刻删除
git filter-branch --force --index-filter \
  "git rm --cached --ignore-unmatch config/password.txt" \
  --prune-empty -- --all

# 第二步：强制推送覆盖
git push origin --force --all

# 第三步：通知团队所有成员重新 clone