Git对等模式下互用非裸仓库作为远程的潜在问题咨询

这种方案完全可行，非常适配你文档整理的场景，但需要注意几个非裸仓库特有的限制，下面详细说明：

一、核心可行性确认 #

Git本质是分布式版本控制系统，完全支持将本地文件路径（包括SMB等网络共享挂载后的路径）作为远程仓库，不管是裸仓库还是非裸仓库，只要文件系统能正常读写，就能完成拉取、推送等操作，不需要额外的Git服务器或守护进程。

二、非裸仓库操作的关键限制与解决方法 #

非裸仓库因为包含工作区，默认有一些推送限制，针对你的场景可以这样处理：

• 推送当前检出分支被拒绝：默认情况下，Git不允许推送到非裸仓库当前正在检出的分支（会覆盖工作区内容）。你可以在SMB共享的仓库里执行以下命令，让Git允许推送更新当前分支的工作区：

  git config receive.denyCurrentBranch updateInstead
  

  这个配置非常适合文档场景，因为文档修改不会有代码那种编译依赖，推送后直接更新工作区内容很方便。
• 避免同时操作同一仓库：不要在多台设备同时对SMB共享的仓库进行工作区修改，否则可能导致文件冲突或Git状态混乱。你的场景是居家用共享端、外出用笔记本，不同时操作，这个风险可以忽略。

三、具体操作步骤 #

1. 挂载SMB共享：
   • Linux/macOS：将SMB共享挂载到本地路径，比如：

     mount -t cifs //myshare/somewhere /mnt/smb-repo -o username=xxx,password=xxx
     

   • Windows：通过资源管理器挂载SMB共享为网络驱动器（比如Z盘）。
2. 互设远程仓库：
   • 在本地笔记本仓库（~/frank/repo）添加SMB远程：

     git remote add smb /mnt/smb-repo  # Linux/macOS
     # 或Windows下：git remote add smb Z:\smb-repo
     

   • 在SMB共享的仓库中添加笔记本远程（如果共享端能访问笔记本的共享目录）：

     git remote add laptop /path/to/laptop/shared/repo
     

     如果共享端无法直接访问笔记本，也可以省略这一步，外出回来后在笔记本上主动拉取SMB仓库的更新即可。
3. 日常工作流程：
   • 居家时：直接在SMB共享仓库中编辑文档、提交；或者在本地笔记本编辑后推送到SMB远程。
   • 外出时：在本地笔记本编辑、提交，无需推送（因为无法访问SMB）。
   • 回家后：挂载SMB共享，先拉取SMB仓库的更新（git pull smb main），解决可能的微小冲突，再推送本地提交到SMB远程（git push smb main）。

四、适配你场景的优势 #

• 完全满足文档整理需求：提供完整的版本历史、误删恢复、提交日志（记录何人何时修改了什么），这是rsync/xcopy无法实现的。
• 无需额外服务器：仅通过SMB文件共享就能实现分布式协作，符合你避免第三方仓库的需求。
• 操作简单：不需要配置Git守护进程或SSH，只要会基础Git操作就能上手。

五、潜在风险提醒 #

• SMB挂载稳定性：操作前确保SMB共享挂载正常，如果挂载中断，Git操作可能失败，重新挂载后重试即可。
• 冲突处理：虽然你预计不会有重大冲突，但还是建议每次提交前拉取最新版本，万一有小冲突，Git的合并工具可以轻松解决。
• 权限问题：确保SMB共享的读写权限足够，避免Git操作时出现权限不足的错误。

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