Windows端VS Code连接树莓派PHP服务器URL异常求助

核心问题定位 #

错误URL中的///192.168.178.85是Windows挂载树莓派共享文件夹的UNC路径（\\192.168.178.130\html\aTotz）被VS Code的PHP Server/Live Server扩展错误解析，与树莓派服务器地址拼接后产生冗余段。同时注意到配置中的IP存在不一致（树莓派IP同时出现192.168.1.130和192.168.178.130），需先统一为树莓派实际局域网IP。

解决方案（无需SSH远程，保留Windows端操作） #

方案1：将网络共享映射为Windows本地驱动器 #

这是最直接的修复方式，让VS Code把共享文件夹识别为本地路径，避免UNC路径解析错误：

1. 右键「此电脑」→ 选择「映射网络驱动器」
2. 选择一个未使用的盘符（如Z:），在「文件夹」栏输入\\[树莓派正确IP]\html\Totz，勾选「登录时重新连接」
3. 打开VS Code的.code-workspace文件，将路径修改为映射后的盘符：

   "path": "Z:\\"
   

4. 重启VS Code后启动PHP Server/Live Server，生成的URL会自动拼接树莓派IP与项目相对路径，不再包含冗余的UNC地址。

方案2：配置PHP Server扩展的路径映射 #

如果不想修改工作区路径，可通过扩展的路径映射功能让VS Code正确关联本地挂载路径与树莓派实际网站路径：
打开VS Code的settings.json，添加/修改以下配置：

// 统一树莓派IP为实际值
"phpserver.ip": "192.168.1.130",
"phpserver.relativePath": "/var/www/html",
// 添加路径映射：Windows挂载路径 ↔ 树莓派实际路径
"phpserver.pathMappings": [
    {
        "local": "\\\\192.168.1.130\\html\\Totz",
        "remote": "/var/www/html/Totz"
    }
]

该配置会告诉PHP Server扩展，Windows端访问的UNC路径对应树莓派上的网站目录，生成URL时会直接使用树莓派IP+相对路径。

方案3：调整Live Server扩展配置 #

针对Live Server的URL异常，修改settings.json中的以下参数：

"liveServer.settings.host": "192.168.1.130",
"liveServer.settings.useLocalIp": false,
"liveServer.settings.root": "/Totz", // 对应树莓派网站目录的相对路径
"liveServer.settings.port": 5500

通过指定root为树莓派上的项目相对路径，Live Server会生成正确的http://192.168.1.130:5500/[项目文件路径]格式URL。

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