如何在Git中保留本地修改不提交且避免误推至master分支

针对你遇到的场景——既要保留本地注释外部服务的桩代码，又能放心用git commit -am提交其他修改、避免误推到master分支，这里有几个精准适配的Git方案：

1. git update-index --skip-worktree（首推方案） #

这个命令专门为Git跟踪但本地需持续修改且不想提交的文件设计，比类似命令更可靠：它会明确告诉Git“我本地对这个文件的修改是特意保留的，不要覆盖，也别把它纳入提交范围”。

操作步骤： #

• 确保目标文件已经被Git跟踪（即之前已提交到仓库）
• 执行标记命令：

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

• 之后你再用git commit -am "xxx"时，Git会自动忽略该文件的修改，完全不影响其他文件的提交流程。

恢复正常提交（当你真需要修改并推送该文件时）： #

先取消标记，再进行提交：

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

提交完成后，你可以重新执行--skip-worktree命令，继续保留本地的桩代码。

2. 备选：git update-index --assume-unchanged #

这个命令逻辑是告诉Git“该文件没有被修改”，适合目标文件很少被上游团队更新的场景。如果上游频繁修改该文件，你执行git pull时，Git可能会直接覆盖你的本地修改（因为它认为文件无变更），所以更推荐优先用上面的skip-worktree。

操作步骤： #

# 标记文件为“未修改”，提交时自动忽略
git update-index --assume-unchanged path/to/your/target-file

# 取消标记，恢复可提交状态
git update-index --no-assume-unchanged path/to/your/target-file

3. 预提交钩子（彻底杜绝误提交） #

如果你想从提交环节直接拦截该文件的误提交，可以设置Git的预提交钩子：

操作步骤： #

• 在项目的.git/hooks目录下，创建无后缀的pre-commit文件，内容如下：

  #!/bin/sh
  # 检查目标文件是否被加入暂存区，是则阻止提交
  if git diff --name-only --cached | grep -q "path/to/your/target-file"; then
      echo "⚠️ 禁止提交target-file的本地修改！若需提交请加--no-verify参数"
      exit 1
  fi
  exit 0
  

• 给文件添加执行权限：

  chmod +x .git/hooks/pre-commit
  

之后每次执行git commit时，如果该文件被误加入暂存区，钩子会直接阻止提交并给出提示。你需要提交该文件时，只需加--no-verify参数即可跳过检查。

这几个方案里，--skip-worktree最贴合你的需求：既不用修改.gitignore，又能灵活控制文件的提交状态，日常用git commit -am完全不用操心误带桩代码。

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