Win10执行node-gyp rebuild报错求助（附环境与日志）

问题概述 #

执行node-gyp rebuild时出现MSB4018错误，提示“不支持此路径格式”，使用管理员权限运行仍无法解决。

环境配置 #

• Windows 10 系统
• Node.js 版本：14.15.0
• Python 版本：3.10.7
• 已安装 Microsoft Visual Studio 2017 Build Tools
• 使用 Git Bash 终端

关键错误日志 #

C:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools\MSBuild\15.0\Bin\Microsoft.Common.CurrentVersion.targets(2850,5): error MSB4018: 执行AssignTargetPath任务时发生意外错误。[D:\dev\web-chat-core\build\binding.vcxproj]
C:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools\MSBuild\15.0\Bin\Microsoft.Common.CurrentVersion.targets(2850,5): error MSB4018: System.NotSupportedException: 不支持此路径格式。[D:\dev\web-chat-core\build\binding.vcxproj]

修复步骤 #

1. 替换Python版本并指定正确路径 #

Node.js 14.x 不兼容 Python 3.10，且当前使用的微软商店版Python是虚拟路径，MSBuild无法解析：

• 卸载微软商店版Python，安装Python 3.9.x官网版本（安装时勾选“添加到系统PATH”）
• 手动指定node-gyp使用的Python路径：

  npm config set python "C:\Python39\python.exe"
  

2. 绑定node-gyp与VS2017 #

确保VS2017已安装C++开发组件，执行命令配置关联：

npm config set msvs_version 2017

3. 清理缓存后重新构建 #

# 删除现有依赖和构建文件
rm -rf node_modules build
# 清理npm缓存
npm cache clean --force
# 重新安装依赖
npm install
# 执行重构
node-gyp rebuild

4. 切换终端执行 #

Git Bash的路径转义逻辑可能导致MSBuild解析出错，改用管理员身份打开CMD，切换到项目目录后执行：

node-gyp rebuild

错误原因说明 #

1. Python路径问题：微软商店版Python的路径是虚拟快捷方式，MSBuild无法识别实际文件路径，触发权限检查错误
2. 版本兼容性：Node.js 14.x 与 Python 3.10 不兼容，node-gyp 9.2.0对高版本Python支持有限
3. 终端路径转义：Git Bash处理Windows路径时的转义逻辑，可能导致MSBuild接收到错误格式的路径

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