如何在网络驱动器搭建Git远程仓库并解决推送异常问题

这种在公司网络共享目录搭建Git远程仓库遇到推送失败的情况我之前也碰到过，大概率是权限或者仓库配置的问题，咱们一步步排查解决：

1. 先查网络驱动器的权限问题 #

• 首先确认你同事的账号对网络驱动器上的Git仓库文件夹拥有完整的读写权限。很多时候推送失败都是因为远程目录只开放了读权限，导致Git无法更新仓库的 refs 和 objects 目录。
• 可以先让同事试试直接在仓库文件夹里新建一个文本文件，如果创建失败，那肯定是权限问题，找IT部门调整文件夹的读写权限就好。

2. 确认远程仓库是「裸仓库」（Bare Repository） #

• 你最开始创建远程仓库的时候，是不是直接在网络驱动器里建了文件夹然后执行git init？如果是普通仓库而非裸仓库，推送大概率会失败——Git默认禁止推送到非裸仓库的当前分支，因为会和远程仓库的工作区产生冲突。
• 解决方法有两种：
  • 把现有仓库转成裸仓库：
    1. 先备份原仓库里除了.git文件夹之外的所有文件（如果有的话）
    2. 删除原仓库根目录下的所有文件，只保留.git文件夹
    3. 进入.git文件夹，把里面的所有文件移动到上级目录（也就是原来的仓库根目录）
    4. 删除空的.git文件夹，然后执行git config --bool core.bare true
  • 更简单的方式：直接重新创建一个裸仓库，执行git init --bare \\server\share\your-repo.git（用UNC路径更稳妥），然后你把本地仓库的远程地址更新为这个新仓库，重新推送一次；同事那边也更新远程地址后再尝试推送。

3. 检查同事本地的远程仓库配置 #

• 让同事在本地仓库里执行git remote -v，看看远程仓库的地址是不是正确的——比如你用的是Z盘映射，同事可能映射成了Y盘？路径不一致就会导致推送失败。
• 建议把远程地址换成UNC路径（比如\\公司服务器名\共享目录\仓库名.git），这样不管同事把网络驱动器映射成哪个盘符，都能正常访问。

4. 处理Git的文件锁定冲突 #

• 网络共享目录有时候会因为文件锁定导致Git操作失败，尤其是多用户同时操作的时候。
• 让同事先拉取最新的远程代码：git fetch origin，然后合并或变基：git pull origin main（替换成你们实际用的分支名），解决完本地冲突后，再执行git push origin main尝试推送。
• 如果还是提示锁定错误，可以手动去网络仓库的.git/refs/heads或者.git/objects/pack目录下，删除所有带.lock后缀的文件，然后再试。

5. 检查Git版本兼容性 #

• 偶尔也会遇到不同Git版本的兼容性问题，比如同事的Git版本太老，对新的仓库格式支持不佳。
• 让同事升级到最新的稳定版Git，再尝试推送操作。

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