VS Code Git插件操作Samba共享仓库报错求助

Windows下通过VS Code对接树莓派Docker Compose部署的Samba共享（映射为X盘），根目录的Git仓库在使用插件暂存.gitignore时，报错提示文件位于仓库//IP/openhab_docker外部，但终端执行git add完全正常。迁移仓库到子文件夹可暂时解决但工作量大，且push仍有异常。

问题根源 #

VS Code的Git插件在处理Windows映射网络驱动器（X:）和Samba UNC路径（//IP/openhab_docker）时，存在路径解析不一致的问题，导致根目录的文件被误判为仓库外部资源。

解决方案 #

• 强制VS Code使用Windows版Git
  打开VS Code设置（Ctrl+,），搜索并配置以下选项：

  • git.path：设置为Windows Git的绝对路径，比如C:\Program Files\Git\bin\git.exe
  • git.useWindowsGit：设为true，避免插件混用WSL或其他环境的Git导致路径转换错误

• 重新以映射路径添加仓库
  打开命令面板（Ctrl+Shift+P），输入Git: Add Local Repository，选择X盘根目录（X:\）作为仓库路径，而非通过UNC路径添加。让插件以Windows映射驱动器的路径识别仓库，和终端操作的路径上下文保持一致。

• 调整Samba共享配置
  在树莓派上编辑Samba配置文件/etc/samba/smb.conf，找到对应共享openhab_docker的配置段，添加以下参数：

  follow symlinks = yes
  wide links = yes
  

  若全局配置中未开启wide links，也需要在[global]段添加该参数。修改后重启Samba服务：

  sudo systemctl restart smbd nmbd
  

  该配置能优化Windows端对共享目录文件结构的识别精度。

• 临时替代方案
  既然终端git add操作正常，可先通过终端执行git add .gitignore或git add .完成暂存，再回到VS Code的Git插件中执行提交操作，无需迁移仓库。

关于push异常的补充排查 #

若迁移子文件夹后push仍有问题，先在终端执行git push验证是否正常：

• 若终端push正常，检查VS Code的Git插件设置git.remoteFetchAll是否开启，或尝试重启VS Code后再操作
• 若终端push也异常，检查Git远程仓库的URL配置（执行git remote -v查看），确保路径或权限正确，同时确认树莓派端的Git仓库权限设置正常

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