在日常开发中，你是否遇到过这样的窘境：为了让项目跑起来，你不得不修改 config.yaml 里的数据库密码，但这些信息绝对不能提交。这时候，.gitignore 因为文件已被追踪而失效，每次 git status 看到那个红色的修改记录都心惊胆战。
今天介绍的 git update-index --assume-unchanged 就是解决这个问题的“黑魔法”。
一、 什么是 assume-unchanged？
简单来说，这是 Git 的一个索引标记。当你对一个文件设置该标志后，Git 会假装这个文件从未被动过。即使你修改了内容，运行 git status 也会显示 “nothing to commit”。
典型使用场景
- 本地环境配置： 修改已追踪的配置文件（如 API 密钥、数据库连接），但不希望污染提交记录。
- 临时调试： 在核心代码中插入调试日志（printf/console.log），却不想在
git status列表里看到它。 - 性能优化： 在超大型项目中，停止对某些几乎不改动的大文件进行哈希校验，提升响应速度。
二、 操作指南
- 施展“隐藏咒”：
git update-index --assume-unchanged <file> - 解除“魔法”：
git update-index --no-assume-unchanged <file> - 寻找“失踪”的文件：
git ls-files -v | grep '^[a-z]'（标记为小写字母h的即为隐藏文件）。
三、 深度解析：它会跟随分支切换吗？
这是很多开发者最关心的问题。答案是：不，它不跟随分支，它只存在于你的本地索引（Index）中。
1. 它是“本地限定”的
该命令操作的是本地的 .git/index 文件。这意味着：
- 不会影响他人： 你推送到远端后，同事拉取的代码依然是正常追踪状态。
- 跨分支生效： 因为标志是绑定在文件路径上的，如果你在
master分支设置了忽略，切换到develop分支时，只要该路径下有同名文件，忽略状态通常会持续生效。
2. 切换分支时的“撞车”风险
虽然标志会持续，但如果两个分支间该文件内容不一致，会发生以下情况：
- 如果你尝试切换到一个对该文件有不同修改的分支，Git 会因为无法平滑更新工作区而报错。
- 由于你开启了“掩耳盗铃”模式，
git status不会告诉你发生了什么。你必须先手动执行--no-assume-unchanged恢复追踪，解决冲突后才能成功切换。
四、 避坑指南：三者的本质区别
| 特性 | .gitignore | assume-unchanged | skip-worktree |
|---|---|---|---|
| 针对对象 | 未被追踪的文件 | 已被追踪的文件 | 已被追踪的文件 |
| 作用域 | 全局（随仓库分发） | 仅本地本地（不随分支） | 仅本地（不随分支） |
| 会被覆盖吗？ | 不受影响 | 会被 git pull 或分支更新覆盖 | 语义上更倾向于保护本地修改 |
五、 重要警告 [!CAUTION]
- 它不是备份工具： 执行了该命令后，如果执行
git reset --hard，你的本地修改依然会丢失。它只是让 Git “视而不见”，并不会保护数据。 - 推荐替代方案： 如果你的改动是长期的本地配置，建议使用
git update-index --skip-worktree。它在处理远程冲突时比assume-unchanged更加稳健（Git 会更明确地提示该文件受保护）。
总结
assume-unchanged 就像是你给本地 Git 戴上了一副墨镜。这副墨镜是你自己戴的，换个房间（换个分支）墨镜还在，但你并没有把这副墨镜写进房间的装修清单里。它是一个好用的临时辅助工具，但请记得在真正需要提交变更时，及时摘下墨镜！
