如何自动添加Git仓库上永不提交的本地开发调试修改？

针对你提到的本地调试修改不能提交、担心误推的问题，以下是几个比单独维护本地分支更稳妥的方案：

1. Stash + 自动恢复脚本 #

把调试修改存入Git stash，再通过脚本实现拉取代码后自动恢复：

• 先将当前调试修改存入stash：

  git stash save "local-debug-hacks"
  

• 编写简单的脚本（比如post-pull.sh），内容如下：

  #!/bin/bash
  git pull
  # 尝试应用指定的stash（如果存在）
  git stash apply "local-debug-hacks"
  

• 给脚本加执行权限：chmod +x post-pull.sh，之后每次拉取代码直接运行这个脚本即可。
• 也可以借助Git的post-merge钩子（放在.git/hooks/post-merge），实现每次合并（包括pull后的merge）自动应用stash，钩子脚本逻辑和上面类似。

优点：完全不污染分支，修改只存在于本地stash；缺点：切换分支或清理stash时要注意不要误删这个调试stash。

2. 标记文件为「忽略本地修改」 #

使用Git的skip-worktree标记，让Git彻底忽略指定文件的本地修改，不会在git status中显示，也不会被提交：

• 标记文件：

  git update-index --skip-worktree path/to/your/file
  

• 取消标记（需要提交修改或恢复原文件时）：

  git update-index --no-skip-worktree path/to/your/file
  

优点：操作简单，无需额外脚本；缺点：只适合单个或少量文件的修改，且标记状态是本地的，换环境需要重新设置。

3. 本地补丁文件 #

将调试修改导出为补丁文件，按需应用或撤销：

• 导出当前调试修改为补丁：

  git diff > debug-patch.diff
  

• 拉取上游代码后，应用补丁：

  git apply debug-patch.diff
  

• 不需要调试时，撤销补丁：

  git apply -R debug-patch.diff
  

优点：修改内容可持久化保存（补丁文件可以存在项目外），灵活控制开关；缺点：上游代码变更较大时可能出现补丁冲突，需要手动解决。

4. 环境变量控制逻辑（项目作者适用） #

如果是项目维护者，无需硬编码#ifdef，改用环境变量控制调试逻辑：

• 代码中加入环境变量判断（以Python为例）：

  import os
  def check_permissions():
      if os.getenv("LOCAL_DEBUG") == "1":
          return True  # 跳过校验
      # 原有的校验逻辑
      ...
  

• 本地开发时，在终端设置环境变量：

  export LOCAL_DEBUG=1
  

  或者在IDE的运行配置中添加该环境变量。

优点：代码无冗余，不影响生产环境；缺点：仅适用于自己有权修改代码逻辑的场景。

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