如何用Git提交本地仓库变更且不推送到远程仓库

看起来你在团队协作中遇到了Git追踪文件里本地专属路径的头疼问题——现有stash的方法确实容易让团队成员踩坑，我给你几个完美适配所有约束的Git原生解决方案，操作简单还不容易出错：

方法一：git update-index --skip-worktree（最推荐） #

这个Git内置功能就是专门为「需要追踪文件，但要保留本地专属变更不提交、不被远程覆盖」的场景设计的，完全匹配你的需求：

初始化操作（一次搞定） #

1. 先把special_file.txt里的路径改成你本地的正确值（文件本来就在Git追踪范围内，不用额外处理）
2. 运行命令标记该文件：

   git update-index --skip-worktree special_file.txt
   

   如果有大量这类文件，可以批量处理（比如匹配特定目录或后缀）：

   # 示例：给config目录下所有文件打标记
   find config/ -type f | xargs git update-index --skip-worktree
   

日常工作流 #

• 修改文件的共享内容（非路径部分）：先临时取消标记，提交共享变更后再重新标记：

  # 取消标记，让Git能识别共享内容的修改
  git update-index --no-skip-worktree special_file.txt
  # 修改共享内容后提交
  git add special_file.txt
  git commit -m "Update shared config content"
  # 重新标记，保护本地路径不被提交/覆盖
  git update-index --skip-worktree special_file.txt
  

• 拉取/合并远程变更：完全不用stash！Git会自动跳过这个文件的合并操作，不会和你的本地路径冲突。
• 推送变更：Git只会推送你提交过的共享内容变更，本地路径的修改根本不会被推送到远程仓库。

查看标记状态 #

用下面的命令可以快速查看哪些文件被标记了skip-worktree：

git ls-files -v | grep '^S'

方法二：git update-index --assume-unchanged（备选方案） #

这个标记和skip-worktree功能类似，但更适合「文件的共享内容不会被远程仓库修改」的场景。如果你的special_file.txt经常有团队成员修改共享内容，还是优先用skip-worktree——因为assume-unchanged在远程有变更时，可能会导致意想不到的冲突。

操作步骤和skip-worktree几乎一致，只是命令换成：

# 打标记
git update-index --assume-unchanged special_file.txt
# 取消标记
git update-index --no-assume-unchanged special_file.txt

为什么这两个方案符合你的所有约束？ #

• 无需修改工具行为：文件的位置和名称完全符合工具的搜索要求
• 每个克隆独立：标记是本地仓库的专属设置，不会同步到远程，每个克隆可以有自己的专属路径
• 共享文件系统无影响：路径是当前克隆独有的，和其他用户的仓库完全隔离
• 支持多克隆：同一个用户的多个Git克隆，都可以单独设置标记和路径
• 不需要环境变量：路径直接写在指定文件里，工具可以直接读取
• 用指定文件：就是仓库里原本的Git追踪文件，不需要额外创建其他文件
• 保留版本控制：文件的共享内容依然可以正常提交、拉取、进行版本管理
• 兼容外部符号链接访问：文件里的路径是正确的本地绝对路径，工具通过符号链接访问完全没问题
• 操作简单：一次标记后，日常协作几乎不用额外操作，团队成员容易上手
• 支持大量文件：可以通过脚本批量标记，不需要逐个处理每个文件

对比你设想的--local-only提交 #

这两个方案比你虚构的本地提交更可靠：本地提交会在Git历史里留下记录，切换分支时反而可能带来冲突；而skip-worktree是让Git直接忽略该文件的本地变更，完全不会影响分支操作和远程同步，日常协作更顺畅。

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