如何让Git忽略指定文件内容变更并保留仓库条目？含测试方法

为什么.gitignore无效？ #

因为change.json已经被提交到GitHub仓库，.gitignore仅对未被Git追踪的文件生效，对已追踪文件不起作用，这时候需要用--skip-worktree参数实现需求。

本地环境操作与测试 #

设置skip-worktree #

1. 打开终端，切换到仓库根目录（即C:\Test）
2. 执行命令：

git update-index --skip-worktree src/app/configs/change.json

（注：Git在Windows下也支持正斜杠路径，无需转义反斜杠）

验证设置生效 #

执行命令查看标记状态：

git ls-files -v

找到src/app/configs/change.json，如果前面的标记是大写S，说明skip-worktree已成功设置。

测试提交效果 #

1. 修改change.json的内容
2. 执行git status，该文件不会出现在"Changes not staged for commit"列表中
3. 执行git add .或git commit -m "test"，该文件的变更不会被提交到仓库

取消设置（如需恢复） #

如果后续需要提交该文件的变更，执行：

git update-index --no-skip-worktree src/app/configs/change.json

CI环境操作与测试 #

CI环境每次拉取代码都是全新克隆，本地的skip-worktree设置不会被保留，需要在CI脚本中自动配置：

在CI脚本中添加设置步骤 #

在拉取仓库代码的步骤之后，添加命令：

git update-index --skip-worktree src/app/configs/change.json

（确保CI工作目录是仓库根目录，路径与本地一致）

测试CI中的效果 #

在CI脚本中添加测试步骤：

1. 修改change.json内容（比如用echo "test" >> src/app/configs/change.json）
2. 执行git status，检查输出中是否没有该文件的变更记录
3. 若CI流程包含提交操作，确认提交后仓库中的change.json未被更新

注意事项 #

如果CI流程需要临时修改并提交该文件，需先取消skip-worktree：

git update-index --no-skip-worktree src/app/configs/change.json
# 执行修改操作
git update-index --skip-worktree src/app/configs/change.json

内容的提问来源于stack exchange，提问作者mad hu