006、Git高级避坑：撤销操作、储藏、标签与.gitignore最佳实践

上周排查一个嵌入式驱动问题，追到某个提交时发现同事半年前改坏了一行配置参数。他试图用git reset回退，结果把两天的工作记录冲掉了，最后只能凭记忆重写。这类事故在团队里反复上演——Git的高级功能用好了是利器，用岔了就是数据灾难。

今天我们就聊聊那些容易踩坑的高级操作。

撤销操作：分清三种“后悔药”

很多人搞混git reset、git revert和git checkout。简单说：

• git reset是移动分支指针（改写历史），适合本地补救
• git revert是生成新提交抵消旧提交，适合团队协作
• git checkout是切换分支或恢复文件，不修改提交历史

最危险的场景：已经推送到远程的提交，别用reset。去年有个项目，新人用git reset --hard HEAD~2强行回退远程分支，导致其他三人刚推的代码消失。正确做法是用revert：

# 查看要撤销的提交
git log --oneline -5

# 生成一个反向提交（团队安全）
git revert 提交哈希值

# 如果冲突了，解决后继续
git add .
git revert --continue

本地还没提交的修改，想彻底丢弃？用git checkout -- 文件名恢复单个文件，或者git reset --hard HEAD清空工作区（慎用！这个命令不经过回收站）。

储藏（stash）：临时切换分支的救星

调试到一半突然要切分支修紧急bug，这时候别急着提交半成品。git stash把工作现场打包存起来：

# 储藏当前修改（包括暂存区）
git stash push -m "调试ADC驱动时的临时状态"  # 一定要写描述！不然一个月后找不回来

# 查看储藏列表
git stash list

# 恢复最近一次储藏（并删除储藏记录）
git stash pop

# 只恢复不删除
git stash apply stash@{1}

踩过坑：有人stash了编译生成的.o文件，恢复时覆盖了新鲜编译的结果。记得在.gitignore里忽略构建产物，或者用git stash --keep-index只储藏已跟踪文件的修改。

标签：别只会打轻量标签

发布固件版本时，打标签比记提交哈希靠谱。但轻量标签就是个引用，附注标签才包含发布者、日期和说明：

# 轻量标签（不推荐用于发布）
git tag v1.0.2

# 附注标签（推荐）
git tag -a v1.0.3 -m "发布稳定版，修复SPI时钟抖动问题"
git push origin v1.0.3  # 标签默认不推送，记得显式推！

# 删除本地标签（远程的也要删）
git tag -d v1.0.2
git push origin --delete v1.0.2

芯片项目常用标签记录流片版本，我们内部约定：v开头是正式发布，rc开头是候选版本，test开头是测试构建。标签命名别用空格和特殊字符，否则有些CI工具会解析失败。

.gitignore最佳实践：少即是多

.gitignore文件写得好，能省一半合并冲突。常见误区：

# 坏例子：忽略整个目录（可能误伤配置文件）
build/

# 好做法：忽略构建产物但保留目录结构
build/*.o
build/*.bin
build/*.hex
!build/README.md  # 保留说明文件

# 嵌入式项目典型配置
*.elf
*.map
*.lst
*.su
*.d
*.axf
/mdk-obj/          # Keil输出目录
/iar/              # IAR输出目录
/.vs/              # VS Code配置（团队协作时排除）

重要规则：

1. 项目根目录放一个.gitignore，全局配置（~/.gitignore）只放个人IDE配置
2. 忽略规则尽早确定，中途添加时已有文件需手动删除：git rm --cached 文件名
3. 用git check-ignore -v 文件路径调试为什么忽略失效

曾有个同事提交了1GB的仿真波形数据，因为.gitignore里写了*.vcd却漏了*.vcd.gz。大文件一旦进仓库，用git filter-branch清理都费劲。

个人经验包

Git高级功能像芯片的调试接口——用对了效率倍增，乱碰可能让系统挂死。我的习惯：

1. 任何破坏性操作前先git branch backup/当前日期，建个临时分支兜底，删分支比恢复数据简单十倍。
2. 团队项目禁用git push -f，除非你们有严格的代码评审和备份流程。强制推送是团队历史的橡皮擦。
3. .gitignore模板从项目第一天就定好，用开源模板（如github/gitignore）改，比从零写靠谱。
4. 标签随发布流程自动化，手动打标签迟早会漏。我们是在CI流水线里检测到release/分支合并时自动打标签。
5. 储藏记录每周清一次，git stash clear。那些“临时修改”放久了就是技术债。

最后说个真事：有位工程师离职后，我们发现某个关键模块的调试记录全在他本地储藏栈里，没提交也没文档。Git是分布式版本管理，不是私人笔记本。该提交的别藏着，该推的别只放本地——这是用Git十年最痛的领悟。