如何让Git忽略特定文件本地修改并同步时覆盖本地版本？

我在使用BYOND/Dream Maker引擎开发时，遇到一个局限：无法为二进制文件设置自定义启动参数。目前的临时解决办法是在被Git跟踪的__build.dm文件中，通过注释/取消注释#define语句来配置构建选项，示例如下：

#define option1 //已启用
//#define option2 //已禁用

现在需要满足两个需求：

• 不想把自己本地启用的调试设置推送到远程仓库
• 同时能正常拉取上游仓库中__build.dm的选项变更

试过git update-index --assume-unchanged和git update-index --skip-worktree，但同步时总会出现冲突，找不到自动用上游版本覆盖本地修改的方法。

方案1：用Git的smudge/clean过滤器自动处理 #

这是Git原生的文件内容处理机制，能在拉取和提交时自动调整配置：

• 先在项目根目录创建__build.dm.template模板文件，把__build.dm里的通用公共选项（不含你的本地调试配置）移到这个模板里，提交到Git仓库。
• 在本地Git配置中添加过滤器规则，以自动启用/注释你的调试选项为例：

  git config filter.build-options.smudge 'sed "s|//#define debug_mode|#define debug_mode|"'
  git config filter.build-options.clean 'sed "s|#define debug_mode|//#define debug_mode|"'
  

  这里的debug_mode替换成你实际用的调试定义，smudge会在拉取代码后自动启用它，clean会在提交前自动注释掉，避免推送到远程。
• 在项目的.gitattributes文件中添加规则：

  __build.dm filter=build-options
  

  提交.gitattributes和__build.dm.template到远程，之后拉取和提交时Git会自动处理__build.dm的内容，不用手动修改。

方案2：拆分配置文件彻底隔离本地设置 #

修改项目的构建逻辑，把通用配置和本地配置分开：

• 创建__build_local.dm文件，专门放你的本地调试#define配置，把这个文件加入.gitignore，不让Git跟踪。
• 修改__build.dm，在文件末尾加入：

  #include "__build_local.dm"
  

• __build.dm只保留通用的构建选项并提交到远程，本地调试配置全部放到__build_local.dm里。
  这样既不影响上游__build.dm的同步，本地调试设置也不会被推送到远程，操作起来最省心。

方案3：拉取时强制覆盖本地__build.dm #

如果不想改动现有文件结构，可以在拉取上游代码时，先强制用远程版本覆盖本地的__build.dm，再合并：
每次拉取前执行：

git fetch origin
git checkout origin/main -- __build.dm
git merge origin/main

也可以把这个逻辑写成shell脚本或者Git别名，方便执行：
比如配置别名：

git config alias.pull-build '!git fetch origin && git checkout origin/main -- __build.dm && git merge origin/main'

之后直接用git pull-build代替git pull，就能自动覆盖本地的__build.dm再合并，避免冲突。

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