树莓派Git项目推送至Windows10共享远程备份仓库失败排查

核心问题本质是跨设备访问的路径协议不匹配，加上树莓派和Windows共享没有建立实际的网络连接，和Windows端Git裸仓库的初始化配置没有关系。

直接排查到的两个错误点 #

• 你在树莓派端配置的远程地址file://DESKTOP-UFCQ4N8/thermostat/MyGitRepo1/格式完全无效。按照URI标准结构，双斜杠后到下一个斜杠之间的DESKTOP-UFCQ4N8属于网络主机部分，但Linux系统下的file协议仅支持解析本机文件系统路径，会直接跳过主机部分，仅提取后面的路径段/thermostat/MyGitRepo1/作为目标路径，完全不会触发和远程Windows设备的网络连接。这也是为什么你的报错信息直接提示找不到/thermostat/MyGitRepo1/——系统根本没尝试去访问Windows机器，只是在树莓派本地根目录下查找了不存在的路径。
• Windows端虽然开了文件夹共享，但树莓派没有针对这个SMB共享完成认证、挂载流程，就算路径写对，也没有办法跨网络读取Windows磁盘上的文件，更别说执行Git写操作了。

完整正确配置流程 #

1. 树莓派端安装SMB客户端组件 #

要访问Windows的SMB共享，首先需要在树莓派上安装对应的挂载工具：

sudo apt update && sudo apt install cifs-utils -y

2. 创建固定挂载点，把Windows共享映射到本地文件系统 #

Git原生的file协议仅能识别本地文件路径，所以必须先把Windows的共享文件夹挂载成树莓派本地的目录，才能被Git正常识别：

• 新建固定挂载目录：

sudo mkdir -p /mnt/win_git_backup

• 手动测试挂载，注意替换成你自己的Windows登录账号：

sudo mount -t cifs //DESKTOP-UFCQ4N8/thermostat /mnt/win_git_backup -o username=你的Windows账号用户名,uid=$(id -u pi),gid=$(id -g pi),vers=3.0

参数说明：vers=3.0匹配Win10默认的SMB3协议，避免旧版SMB1的安全兼容问题；uid/gid把挂载后的目录权限设置为pi用户所有，否则Git推送时会因权限不足写入失败。
测试挂载完成后，进入/mnt/win_git_backup目录，能看到之前创建的MyGitRepo1裸仓库，就说明挂载连通了。

• 配置开机自动挂载，避免重启后连接失效：
  先把Windows的账号密码存到树莓派本地的权限受限文件里，避免明文写在系统挂载配置里：

cat > /home/pi/.smb_cred << EOF
username=你的Windows账号用户名
password=你的Windows登录密码
EOF
# 设置文件权限，避免其他用户读取到账号信息
chmod 600 /home/pi/.smb_cred

再把挂载配置写入/etc/fstab：

//DESKTOP-UFCQ4N8/thermostat /mnt/win_git_backup cifs credentials=/home/pi/.smb_cred,uid=1000,gid=1000,vers=3.0,iocharset=utf8 0 0

3. 修正Git远程仓库配置 #

先删掉之前配置错误的远程地址，替换成挂载后的本地路径：

# 删除错误的origin配置
git remote remove origin
# 新增正确的远程地址，指向挂载目录下的裸仓库
git remote add origin /mnt/win_git_backup/MyGitRepo1/

4. 执行推送测试 #

git push origin master

常见踩坑提醒 #

• 不要把Windows本地的网络驱动器映射逻辑套用到Linux端：参考教程里用pushd把共享映射成Z盘，是Windows系统本地的网络驱动器功能，Linux系统没有对应的盘符映射机制，所有网络共享必须挂载成本地目录才能被应用识别。
• 共享权限不要只配置Everyone：新版Win10默认的安全策略下，就算给Everyone开了文件夹权限，没有合法的本地账号做SMB认证，树莓派的连接请求会被直接拒绝。
• 不要尝试用git remote add origin //DESKTOP-UFCQ4N8/xxx这类UNC路径当远程地址：Git不支持直接解析UNC网络路径，必须经过本地挂载转换才能正常访问。

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