如何在Git本地仓库忽略已修改文件,同时保留远程仓库的原始版本
之前操作失效的核心原因
- 已经被Git纳入版本追踪的文件,写入
.gitignore或者本地.git/info/exclude配置,完全不会让Git停止追踪它的改动 - 这两个配置文件的作用范围,仅限从来没有被提交进远程仓库的全新未追踪文件,对已经存在于提交记录里的文件没有任何屏蔽效果,这也是你改了配置还是能看到文件改动的根本原因。
新手友好的可靠实现方案(全程无复杂配置)
只需要在项目根目录的终端里执行1条核心命令,就能彻底解决问题:
- 执行命令标记目标文件,替换成你自己的文件相对路径:
git update-index --skip-worktree 你的目标文件相对路径
举个实际例子:如果需要屏蔽的文件是项目里src/settings/dev.config.js,那输入的命令就是git update-index --skip-worktree src/settings/dev.config.js - 验证配置是否生效:执行命令查看Git对目标文件的追踪状态:
git ls-files -v | grep 目标文件名
如果输出的行首是小写s,就代表配置成功。
配置完成后,后续操作会完全符合预期:
- 本地对这个文件的所有修改,不会被
git status识别为变更 - 执行
git add .全量暂存代码时,Git会自动跳过这个文件的改动,不需要再像之前那样每次暂存后手动把它从暂存区移除 - 执行
git pull拉取远程代码、git push推送本地改动时,远程仓库存储的该文件原始版本不会被覆盖,你本地适配环境的专属配置也不会被远程版本覆盖。
避坑提示
- 不要用
--assume-unchanged参数实现这个需求:这个参数的设计初衷是标记很少变动的大文件,一旦远程仓库的目标文件有更新,你拉代码时很容易触发冲突,而且Git会在检测到文件变动时自动清除这个标记,长期使用可靠性很差。 - 如果后续你需要恢复对这个文件的正常追踪,只需要执行对应命令取消屏蔽:
git update-index --no-skip-worktree 你的目标文件相对路径 - 不需要再反复修改
.gitignore或者.git/info/exclude配置,这两个配置完全不适用于当前的场景,修改后也不会产生你想要的效果。
内容的提问来源于stack exchange,提问作者IronJoo
相关产品推荐
相关产品推荐

