Git仓库中能否将指定文件设为只读禁止提交修改？
2026-10-1
Git 实现模板文件可拉取修改、禁止提交的方案
先明确普通.gitignore的局限性
.gitignore只能作用于未被Git追踪的文件，如果文件已经提交到上游仓库，即便加到.gitignore里，Git依然会持续追踪该文件的修改，无法满足你的需求。
方案1：skip-worktree标记（推荐，适配模板文件场景）
这是最匹配你需求的方案，操作步骤如下：
- 上游仓库正常提交模板配置文件（例如
config.env、settings.py），不要将其加入.gitignore，保证所有开发者拉取代码时可以拿到完整的初始模板 - 开发者克隆仓库完成后，在本地项目根目录执行命令：
git update-index --skip-worktree <模板文件相对路径> # 示例：git update-index --skip-worktree config.env
- 执行完成后，Git会自动忽略本地对该文件的所有修改，修改不会出现在
git status的待变更列表，也不会被提交到仓库，完全不影响开发者本地自定义配置。
补充说明
- 若上游仓库维护者需要更新模板文件，可先执行
git update-index --no-skip-worktree <模板文件路径>解除标记，修改提交后再重新标记即可。 - 该标记仅作用于本地Git环境，不会同步到上游仓库，每个开发者只需要执行一次标记即可。
- 相比
--assume-unchanged标记，--skip-worktree更适配配置文件场景：如果上游更新了模板文件，拉取时会提示冲突，不会强制覆盖你本地的自定义配置，你可以自行选择是否同步上游的模板变更。
方案2：模板文件重命名（无额外命令依赖）
如果不想让开发者执行Git命令，也可以用这个方案：
- 上游仓库仅提交后缀带示例标识的模板文件，例如
config.env.example，将真实使用的config.env加入.gitignore - 开发者拉取代码后，自行复制一份
config.env.example重命名为config.env，在本地修改config.env即可，该文件默认不会被Git追踪，不会提交到仓库。 - 缺点：如果上游更新了模板内容，需要开发者主动对比
config.env.example的变更手动同步，不会自动提醒。
内容的提问来源于stack exchange，提问作者Pietro
相关产品推荐
相关产品推荐
