Git 学习笔记#

$ git status
On branch master                    # 当前在 master 分支
Your branch is up to date with 'origin/master'.

Changes to be committed:            # 暂存区（即将进入 commit）
        new file:   qt/NewModule/src/NewModule.h

Changes not staged for commit:      # 工作区已修改但未暂存
        modified:   cpp/CRC/src/CRC.cpp

Untracked files:                    # 新文件，Git 还没跟踪
        qt/NewModule/example/main.cpp

# 从零创建
mkdir my-project && cd my-project
git init

# 克隆已有仓库
git clone https://gitee.com/hisos/ry-bos.git

# 只克隆最近一次提交（大仓库省时间）
git clone --depth 1 https://gitee.com/hisos/ry-bos.git

# 克隆指定分支
git clone -b master https://gitee.com/hisos/ry-bos.git

# 添加单个文件
git add README.md

# 添加所有修改和新文件
git add .

# 交互式选择要添加的改动（同一文件的部分修改）
git add -p             # p = patch，逐块确认

# 提交
git commit -m "feat: 新增 AsyncTask 异步任务模块"

# 带详细描述
git commit -m "fix: 修复 CRC 计算溢出" -m "uint16_t 溢出改用 uint32_t"

# 跳过暂存区，直接提交所有已跟踪文件的修改（不包括新文件）
git commit -am "docs: 更新 README"

# 工作区 vs 暂存区（还没 add 的改动）
git diff

# 暂存区 vs 版本库（已 add 还没 commit 的改动）
git diff --cached

# 工作区 vs 版本库（所有未提交的改动）
git diff HEAD

# 比较两个分支
git diff master..dev

# 只看哪些文件变了
git diff --stat

# 每个提交一行（最常用）
git log --oneline

# 带分支图（看合并关系）
git log --oneline --graph --all

# 本项目实例
$ git log --oneline --graph --all -10
* 481ac6e (HEAD -> master, origin/master) knowledge: 添加 Linux 学习笔记
* e5b1ac1 Sync live doc template and role skills
* ec16745 docs: sync live template swimlane rules
* fc836d4 docs: require web server hop in swimlanes
* b72d61a docs: clarify swimlane participant rules
* e8eeec1 docs: tighten swimlane response routing rules
* 4ba995a docs: fix swimlane watermark orientation
* 31f49a3 docs: make swimlane watermarks horizontal
* 739b8b9 docs: add swimlane watermarks to live template
* ebc0b5c docs: add live doc template and skills

# 找某个文件的修改历史（含重命名追踪）
git log --follow --oneline -- qt/VideoPlayer/src/QtVideoThread.h

# 看谁在什么时间改了某文件
git log --format="%h %an %ad %s" --date=short -- cpp/CRC/src/CRC.cpp

# 搜索提交信息含 "fix" 的提交
git log --oneline --grep="fix"

# 看最近一周的提交
git log --oneline --since="1 week ago"

# 统计每人提交次数
git shortlog -sn

# 查看某个提交的详情（改了什么）
git show 481ac6e

# 只看改了哪些文件
git show 481ac6e --stat

# 查看某个提交对特定文件的修改
git show 8e3db40 -- qt/ToolBox/

# 看每行是谁、在哪个提交、什么时间写的
git blame README.md

# 只看第 10-20 行
git blame -L 10,20 README.md

# 忽略空格改动
git blame -w README.md

# 查看当前 HEAD 指向
$ cat .git/HEAD
ref: refs/heads/master

# 查看分支指针指向哪个 commit
$ cat .git/refs/heads/master
481ac6e...（40 字符 SHA-1）

# 查看所有本地分支
git branch

# 查看所有分支（含远程）
git branch -a

# 本项目实例
$ git branch -a
* master                      # * 表示当前所在分支
  remotes/origin/HEAD -> origin/master
  remotes/origin/master

# 创建分支（但不切换过去）
git branch dev

# 创建并切换到新分支
git checkout -b dev           # 旧写法
git switch -c dev             # 新写法（Git 2.23+，语义更清晰）

# 切换分支
git checkout master           # 旧写法
git switch master             # 新写法

# 删除分支（安全删除：未合并则拒绝）
git branch -d dev

# 强制删除分支（即使未合并也删）
git branch -D dev

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

# 把 dev 分支合并到当前分支（master）
git merge dev

git merge --no-ff dev    # 强制创建合并提交，保留分支历史

# 把当前分支的提交"搬到" master 最新提交之上
git rebase master

git merge dev
# Auto-merging failed; fix conflicts and then commit the result.

# 1. 查看哪些文件冲突
git status
# both modified:   cpp/CRC/src/CRC.cpp

# 2. 打开冲突文件，手动编辑
#    删除冲突标记（<<<<<<<、=======、>>>>>>>）
#    保留想要的代码，或合并两边的代码

# 3. 标记冲突已解决
git add cpp/CRC/src/CRC.cpp

# 4. 完成合并
git commit -m "merge: 合并 dev 分支，解决 CRC.cpp 冲突"

# 用 VS Code 作为合并工具
git config --global merge.tool vscode
git config --global mergetool.vscode.cmd 'code --wait $MERGED'

# 启动合并工具
git mergetool

# 查看远程仓库
git remote -v
# origin  https://gitee.com/hisos/ry-bos.git (fetch)
# origin  https://gitee.com/hisos/ry-bos.git (push)

# 添加远程仓库
git remote add origin https://gitee.com/hisos/ry-bos.git

# 修改远程仓库地址
git remote set-url origin https://gitee.com/hisos/new-repo.git

# 删除远程仓库
git remote remove origin

# fetch：下载远程更新到 origin/master，但不合并到本地 master
git fetch origin
git fetch --all          # 拉取所有远程

# fetch 后查看远程有什么新东西
git log origin/master --oneline -5
git diff master..origin/master   # 看差异

# 确认后再合并
git merge origin/master

# pull = fetch + merge（一步到位）
git pull
git pull --rebase        # pull = fetch + rebase（更干净的历史）

# push：推送本地提交到远程
git push origin master
git push                 # 简写（当前分支已设置上游时）
git push -u origin dev   # 首次推送 dev 分支并设置上游跟踪
git push --force         # 强制推送（危险！覆盖远程历史）
git push --force-with-lease  # 安全的强制推送（只在远程没有新提交时才覆盖）

# HTTPS（每次可能要输密码，可配置 credential helper 缓存）
git clone https://gitee.com/hisos/ry-bos.git

# SSH（配置好密钥后免密，推荐）
git clone git@gitee.com:hisos/ry-bos.git

# 查看所有标签
git tag

# 创建轻量标签（只是一个指向 commit 的指针）
git tag v1.0

# 创建附注标签（推荐，包含作者、日期、说明信息）
git tag -a v1.0 -m "发布版本 1.0：包含 CRC、AsyncTask、ConfigManager 等 20 个模块"

# 给历史提交打标签
git tag -a v0.9 -m "早期版本" 8e3db40

# 查看标签信息
git show v1.0

# 推送标签到远程（默认 push 不推标签）
git push origin v1.0          # 推单个标签
git push origin --tags        # 推所有标签

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

# --soft：只移动 HEAD，暂存区和工作区不变
# 效果：撤销 commit，改动还在暂存区（可以直接重新 commit）
git reset --soft HEAD~1

# --mixed（默认）：移动 HEAD，暂存区重置，工作区不变
# 效果：撤销 commit + 撤销 add，改动还在工作区
git reset HEAD~1

# --hard：移动 HEAD，暂存区和工作区都重置
# 效果：彻底丢弃所有改动，回到指定 commit 的状态
git reset --hard HEAD~1

# 创建一个"反向提交"来撤销指定 commit
git revert 481ac6e

# 撤销最近一次提交
git revert HEAD

# 撤销多个提交
git revert HEAD~3..HEAD

# 临时保存当前工作区的改动（工作区变干净）
git stash

# 带说明信息
git stash push -m "正在写 VideoPlayer，先切去修 bug"

# 包括未跟踪的文件
git stash -u

# 查看储藏列表
git stash list
# stash@{0}: WIP on master: 481ac6e knowledge: 添加 Linux 学习笔记
# stash@{1}: WIP on master: e5b1ac1 Sync live doc template

# 恢复最近的储藏（并从列表删除）
git stash pop

# 恢复最近的储藏（但保留在列表中）
git stash apply

# 恢复指定储藏
git stash apply stash@{1}

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

# 清空所有储藏
git stash clear

# 预览要删除哪些文件（dry run，安全检查）
git clean -n

# 删除未跟踪的文件
git clean -f

# 删除未跟踪的文件和目录
git clean -fd

# 包括 .gitignore 忽略的文件也一起删
git clean -fdx

# 把 dev 分支上的某个 commit 摘到当前分支
git cherry-pick e5b1ac1

# 摘取多个 commit
git cherry-pick 481ac6e e5b1ac1

# 摘取一个范围
git cherry-pick dev~3..dev

# 查看所有操作记录（包括已经被 reset 掉的 commit）
git reflog
# 481ac6e HEAD@{0}: commit: knowledge: 添加 Linux 学习笔记
# e5b1ac1 HEAD@{1}: commit: Sync live doc template
# ec16745 HEAD@{2}: checkout: moving from dev to master
# ...

# 找回被 reset --hard 误删的提交
git reset --hard HEAD@{2}    # 回到操作前的状态

# 开始二分查找
git bisect start

# 标记当前提交为"有 bug"
git bisect bad

# 标记某个历史提交为"正常"
git bisect good 8e3db40    # 这个版本没有 bug

# Git 自动切到中间的提交，你测试后告诉 Git 结果
git bisect good    # 这个版本正常
git bisect bad     # 这个版本有 bug

# 重复直到 Git 定位到引入 bug 的那个 commit
# 最后结束
git bisect reset

# 全局配置（写入 ~/.gitconfig）
git config --global user.name "hisos"
git config --global user.email "hisos@example.com"
git config --global core.editor "code --wait"
git config --global init.defaultBranch main    # 默认分支名改为 main

# 仓库级配置（写入 .git/config，优先于全局）
git config user.name "another-name"

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

# 查看某项配置
git config user.name

# 设置别名（简化常用命令）
git config --global alias.st "status -sb"
git config --global alias.co "checkout"
git config --global alias.lg "log --oneline --graph --all"
# 之后可以 git lg 代替长命令

# 钩子脚本放在 .git/hooks/ 目录
# 常用钩子：

# pre-commit：提交前触发，可用于代码检查
# commit-msg：提交信息验证
# pre-push：推送前触发

# 示例：强制提交信息符合 Conventional Commits 规范
# .git/hooks/commit-msg
#!/bin/bash
if ! grep -qE "^(feat|fix|docs|refactor|chore|knowledge):" "$1"; then
    echo "提交信息必须以 feat|fix|docs|refactor|chore: 开头"
    exit 1
fi

# 设置全局忽略文件（对所有仓库生效）
git config --global core.excludesfile ~/.gitignore_global

# 解决方法：先从 Git 跟踪中移除（保留本地文件）
git rm --cached <文件>
git commit -m "chore: 停止跟踪 xxx 文件"

# 之后 .gitignore 规则才会对它生效

# 先拉取再推送
git pull --rebase
git push

git reflog                    # 找到丢失的 commit SHA-1
git reset --hard <sha-1>      # 回到那个提交

# 还没 push
git commit --amend -m "正确的信息"

# 已经 push（用 amend + force-with-lease）
git commit --amend -m "正确的信息"
git push --force-with-lease

# 危险操作，会重写所有历史
git filter-branch --tree-filter 'rm -f sensitive.txt' HEAD
# 或用更快的工具
git filter-repo --path sensitive.txt --invert-paths
# 之后需要 force push
git push --force-with-lease

git merge --abort    # 回到合并前的状态

git revert <commit>    # 创建一个反向提交

# 改用 rebase 模式拉取
git pull --rebase

# 设为默认
git config --global pull.rebase true

git show <commit>:path/to/file
# 或检出到工作区
git checkout <commit> -- path/to/file

# 只克隆最近一次提交
git clone --depth 1 <url>

# 克隆后需要完整历史时再补
git fetch --unshallow

git rm --cached <file>                    # 停止跟踪
echo "<file>" >> .gitignore               # 加入忽略
git commit -m "chore: 停止跟踪 <file>"

# 1. 初始化
mkdir my-project && cd my-project
git init
git config user.name "hisos"
git config user.email "hisos@example.com"

# 2. 创建 .gitignore
cat > .gitignore << 'EOF'
build/
*.log
.vs/
.vscode/
EOF

# 3. 首次提交
git add .
git commit -m "feat: 项目初始化"

# 4. 关联远程并推送
git remote add origin git@gitee.com:hisos/my-project.git
git push -u origin master

# 1. 从 master 拉取最新
git switch master
git pull

# 2. 创建功能分支
git switch -c feature/video-player

# 3. 开发并提交（小步多次提交）
git add qt/VideoPlayer/src/QtVideoThread.h
git commit -m "feat: 添加 VideoThread 低延迟 FFmpeg 配置"

git add qt/VideoPlayer/src/QtGLVideoWidget.h
git commit -m "feat: 添加 GLVideoWidget GPU 渲染组件"

# 4. 开发期间同步 master 最新
git fetch origin
git rebase origin/master

# 5. 完成后合并到 master
git switch master
git merge --no-ff feature/video-player

# 6. 推送
git push

# 7. 删除功能分支
git branch -d feature/video-player

# 正在 feature 分支写代码，工作区是脏的
# master 发现紧急 bug！

git stash push -m "WIP: video player 开发中"

git switch master
git switch -c hotfix/crc-overflow

# 修复 bug
git add cpp/CRC/src/CRC.cpp
git commit -m "fix: CRC 计算 uint16_t 溢出改用 uint32_t"

# 合并到 master
git switch master
git merge --no-ff hotfix/crc-overflow
git push

# 删除 hotfix 分支
git branch -d hotfix/crc-overflow

# 回到 feature 分支继续开发
git switch feature/video-player
git stash pop

# 当前版本有 bug，但不知道哪个提交引入的
git bisect start
git bisect bad HEAD              # 当前版本有 bug
git bisect good v0.9             # v0.9 标签的版本正常

# Git 切到中间提交，测试
git bisect good                  # 这个版本正常 → bug 在后半段
# Git 再切到后半段中间
git bisect bad                   # 这个版本有 bug → bug 在前半段
# ... 最多 7 次就能定位

# 定位到引入 bug 的 commit 后
git bisect reset                 # 退出 bisect 模式
git show <bug-commit>            # 查看那个提交改了什么

# 确认在 master 且代码正确
git switch master
git pull

# 创建附注标签
git tag -a v1.0 -m "发布 v1.0：包含 CRC、AsyncTask、ConfigManager 等 20 个模块"

# 推送标签到远程
git push origin v1.0

# 之后任何人都可以精确回到这个版本
git checkout v1.0