多用户机器本地Git LFS仓库执行merge时smudge filter报错如何解决

问题根因 #

你遇到的报错是Git LFS未配置本地文件路径远程仓库的LFS访问规则导致的：

• 其他用户提交的LFS大文件实际存储在他们各自本地克隆的/.git/lfs/objects目录下，你的主仓库中不存在对应哈希的LFS对象
• 你添加的其他用户远程仓库仅配置了Git本身的访问路径，未同步配置LFS的拉取地址，LFS执行下载请求时找不到对应的协议入口，触发missing protocol: ""报错
• 合并中断后未完成的工作区回滚异常，导致非LFS文件变为未跟踪状态

可行解决方案 #

方案1：临时跳过LFS拉取合并（适合单次合并场景） #

1. 合并前临时修改LFS smudge规则，跳过自动拉取：
   git config filter.lfs.smudge "cat"
2. 执行正常合并操作，不会触发LFS下载报错：
   git merge [COMMIT]
3. 手动同步对应用户仓库的LFS对象到你的主仓库：
   cp -r /home/[OTHER USERNAME]/[REPO]/.git/lfs/objects/* /home/[MY USERNAME]/[REPO]/.git/lfs/objects/
4. 恢复LFS默认配置并检出实际大文件：
   git config filter.lfs.smudge "git-lfs smudge -- %f"
git lfs checkout

方案2：配置远程仓库LFS地址（适合长期多用户合并场景） #

针对每个添加的用户远程仓库，单独配置对应的LFS访问地址，示例如下（替换为实际用户名和仓库名）：
git config remote.[OTHER USERNAME].lfsurl "file:///home/[OTHER USERNAME]/[REPO]/.git/lfs"
配置完成后，后续合并时Git LFS会自动通过file协议从对应用户的本地仓库拉取缺失的LFS对象，无需手动操作。

方案3：调整共享仓库架构（推荐多用户长期协作场景） #

在你的家目录创建一个裸仓库作为统一共享中心，所有用户直接向该仓库推送变更，避免手动合并的流程：

1. 新建裸仓库并开启LFS：
   git init --bare [SHARED_REPO_NAME].git
cd [SHARED_REPO_NAME].git
git lfs install --local
2. 所有用户重新克隆该裸仓库，原有变更推送至该仓库即可
3. 你本地直接从该裸仓库拉取变更即可，LFS对象会统一存储在裸仓库中，不会出现跨用户拉取失败的问题

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