# 全局配置用户名和邮箱（提交身份标识）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# 查看所有配置
git config --list

# 设置默认编辑器
git config --global core.editor vim

# 配置别名，简化常用命令
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --oneline --graph --all"

# 在当前目录初始化一个新仓库
git init

# 克隆远程仓库
git clone <url>

# 克隆到指定目录
git clone <url> <dir>

# 克隆指定分支
git clone -b <branch> <url>

# 仅克隆最近一次提交（节省时间空间，适合大仓库）
git clone --depth 1 <url>

# 查看当前状态
git status

# 查看未暂存的修改
git diff

# 查看已暂存但未提交的修改
git diff --cached

# 暂存单个文件
git add <file>

# 暂存所有修改（含新增、修改、删除）
git add -A
git add .

# 交互式选择暂存内容（按 hunk 暂存）
git add -p

# 提交
git commit -m "commit message"

# 提交时同时附加详细说明
git commit -m "title" -m "body..."

# 修改上一次提交（追加文件或修改信息，前提是未 push）
git commit --amend
git commit --amend --no-edit    # 保持原信息

# 列出本地分支
git branch

# 列出所有分支（含远程）
git branch -a

# 创建新分支（不切换）
git branch <name>

# 创建并切换到新分支
git checkout -b <name>
# 新版本写法
git switch -c <name>

# 切换分支
git checkout <name>
git switch <name>

# 删除本地分支（安全删除，未合并会拒绝）
git branch -d <name>

# 强制删除分支
git branch -D <name>

# 删除远程分支
git push origin --delete <name>

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

# 合并指定分支到当前分支（生成 merge commit）
git merge <branch>

# 变基：把当前分支的提交"搬到"目标分支顶端，保持线性历史
git rebase <branch>

# 交互式变基，常用场景：
#   - 压缩多个提交（squash）
#   - 修改历史提交信息
#   - 调整提交顺序
git rebase -i HEAD~3

# 变基冲突解决流程
# 1. 手动编辑冲突文件，移除 <<<<<<< ======= >>>>>>> 标记
# 2. git add <冲突文件>
# 3. git rebase --continue
# 或放弃变基：git rebase --abort

# 终止本次合并
git merge --abort

# 查看远程仓库
git remote -v

# 添加远程仓库
git remote add <name> <url>          # 例如 git remote add upstream ...

# 修改远程仓库地址
git remote set-url <name> <url>

# 移除远程仓库
git remote remove <name>

# 拉取远程更新但不合并（推荐，比 pull 更安全）
git fetch <remote>

# 拉取并合并到当前分支 = fetch + merge
git pull <remote> <branch>
git pull --rebase                   # 拉取后变基而非合并

# 推送本地提交到远程
git push <remote> <branch>

# 推送并建立追踪关系（首次推送）
git push -u origin <branch>

# 强制推送（危险！会覆盖远程历史）
git push --force-with-lease         # 比 --force 安全，远程有他人提交时会拒绝

# 查看提交历史
git log

# 单行紧凑模式
git log --oneline

# 图形化展示分支
git log --oneline --graph --all --decorate

# 显示每次提交的 diff
git log -p

# 显示每次提交的文件变更统计
git log --stat

# 查看某个文件的修改历史
git log -- <file>

# 搜索提交信息
git log --grep="keyword"

# 查看某次提交的详细内容
git show <commit-id>

# 撤销工作区某文件的修改（危险！未保存的修改会丢失）
git checkout -- <file>
git restore <file>                   # 新写法

# 撤销暂存（保留工作区修改）
git reset HEAD <file>
git restore --staged <file>          # 新写法

# 撤销已提交但未推送的 commit（保留修改在工作区）
git reset --soft HEAD~1              # 撤销 commit，保留暂存
git reset HEAD~1                     # 默认 mixed，撤销 commit 和暂存
git reset --hard HEAD~1              # 彻底丢弃（危险）

# 通过新 commit 撤销历史 commit（公共分支安全）
git revert <commit-id>

# 临时保存工作区与暂存区修改（不提交）
git stash

# 含未跟踪文件
git stash -u

# 给 stash 加说明
git stash save "message"

# 查看 stash 列表
git stash list

# 恢复最近一次 stash（保留在 stash 列表）
git stash apply

# 恢复并删除最近一次 stash
git stash pop

# 恢复指定 stash
git stash apply stash@{2}

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

# 清空所有 stash
git stash clear

# 列出标签
git tag

# 创建轻量标签
git tag v1.0.0

# 创建带注释的标签（推荐，含作者、时间、说明）
git tag -a v1.0.0 -m "Release v1.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

# 二分查找定位引入 bug 的 commit
git bisect start
git bisect bad                    # 当前版本有问题
git bisect good <commit-id>       # 标记一个已知正常的版本
# Git 会自动 checkout 中间版本，测试后：
git bisect good   # 或 git bisect bad
git bisect reset                  # 结束 bisect

# 挑选某次 commit 应用到当前分支
git cherry-pick <commit-id>

# 使用 reflog 找回"丢失"的 commit（reset/rebase 后）
git reflog

# 把某次提交从历史中彻底移除（敏感信息泄露场景）
git filter-branch --tree-filter 'rm -f <file>' HEAD
# 或使用更快的工具：git filter-repo

# 从 Gerrit 服务器下载 hook 到本地 .git/hooks 目录
cd <repo>
scp -p -P 29418 <user>@<gerrit-server>:hooks/commit-msg .git/hooks/

# 给 hook 可执行权限（Linux/Mac）
chmod +x .git/hooks/commit-msg

# 1. 切到目标分支并同步最新
git checkout master
git pull --rebase

# 2. 基于最新代码创建工作分支（可选，但推荐）
git checkout -b feature/add-login

# 3. 修改代码
vim src/login.c

# 4. 暂存并提交（commit-msg hook 会自动追加 Change-Id）
git add src/login.c
git commit -s -m "feature: add login function

Implement the login flow with token-based auth.

Signed-off-by: Your Name <you@example.com>"

# 5. 推送到 Gerrit 评审
git push origin HEAD:refs/for/master

git push origin HEAD:refs/for/master%topic=login-feature

# 1. 根据评审意见修改代码
vim src/login.c

# 2. 暂存修改
git add src/login.c

# 3. amend 到上一次 commit（Change-Id 会被保留）
git commit --amend --no-edit
# 或同时修改 commit message：
git commit --amend

# 4. 再次推送（Gerrit 会自动识别为同一 Change 的新版本）
git push origin HEAD:refs/for/master

# 1. 从 Gerrit 网页找到该 Change 的 Change-Id（如 I1234567890abcdef...）
# 2. amend commit message
git commit --amend
# 3. 在 commit message 末尾添加一行：
#    Change-Id: I1234567890abcdef...
# 4. 重新推送

java -jar .git/hooks/commit-msg  # 重新生成

# 假设分支上有三个 commit
git log --oneline
# c3 third commit
# c2 second commit
# c1 first commit

git push origin HEAD:refs/for/master
# → 产生三个 Change: c1, c2, c3
# → c2 depends-on c1, c3 depends-on c2
# → 评审顺序：c1 先 +2 合入，c2 才可合入，c3 同理

# 0. 首次配置（每台机器一次）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# 1. 克隆仓库（自动含 hook）
git clone -o origin ssh://<user>@<gerrit>:29418/<project>
cd <project>

# 2. 同步主干
git checkout master
git pull --rebase

# 3. 开发
git checkout -b feature/xxx
# ... 修改代码 ...
git add -p
git commit -s -m "feat: xxx"
# hook 自动追加 Change-Id

# 4. 推评审
git push origin HEAD:refs/for/master

# 5. 评审反馈，amend 修订
git add -p
git commit --amend --no-edit
git push origin HEAD:refs/for/master

# 6. 评审通过 + Submit 自动合入
# 7. 同步主干，继续下一个任务
git checkout master
git pull --rebase