执行npm install --force时遇node-gyp找不到Visual Studio问题求助

执行npm install --force安装Codecanyon脚本依赖时，遭遇node-gyp错误：Could not find any Visual Studio installation to use。已尝试重装最新版Node.js、Python及Visual Studio Build Tools，添加VCINSTALLDIR到系统路径，多次重启Windows，但问题仍未解决。

完整错误日志 #

npm ERR! code 1
npm ERR! path C:\Users\denis\OneDrive\Documents\Website\node_modules\node-sass
npm ERR! command failed
npm ERR! command C:\Windows\system32\cmd.exe /d /s /c node scripts/build.js
npm ERR! Building: C:\Program Files\nodejs\node.exe C:\Users\denis\OneDrive\Documents\Website\node_modules\node-gyp\bin\node-gyp.js rebuild --verbose --libsass_ext= --libsass_cflags= --libsass_ldflags= --libsass_library=
npm ERR! gyp info it worked if it ends with ok
npm ERR! gyp verb cli [
npm ERR! gyp verb cli   'C:\\Program Files\\nodejs\\node.exe',
npm ERR! gyp verb cli   'C:\\Users\\denis\\OneDrive\\Documents\\Website\\node_modules\\node-gyp\\bin\\node-gyp.js',
npm ERR! gyp verb cli   'rebuild',
npm ERR! gyp verb cli   '--verbose',
npm ERR! gyp verb cli   '--libsass_ext=',
npm ERR! gyp verb cli   '--libsass_cflags=',
npm ERR! gyp verb cli   '--libsass_ldflags=',
npm ERR! gyp verb cli   '--libsass_library='
npm ERR! gyp verb cli ]
npm ERR! gyp info using node-gyp@8.4.1
npm ERR! gyp info using node@19.2.0 | win32 | x64
npm ERR! gyp verb command rebuild []
npm ERR! gyp verb command clean []
npm ERR! gyp verb clean removing "build" directory
npm ERR! gyp verb command configure []
npm ERR! gyp verb find Python checking Python explicitly set from command line or npm configuration
npm ERR! gyp verb find Python - "--python=" or "npm config get python" is "C:\Python311\python.exe"
npm ERR! gyp verb find Python - executing "C:\Python311\python.exe" to get executable path
npm ERR! gyp verb find Python - executable path is "C:\Python311\python.exe"
npm ERR! gyp verb find Python - executing "C:\Python311\python.exe" to get version
npm ERR! gyp verb find Python - version is "3.11.0"
npm ERR! gyp info find Python using Python version 3.11.0 found at "C:\Python311\python.exe"
npm ERR! gyp verb get node dir no --target version specified, falling back to host node version: 19.2.0
npm ERR! gyp verb command install [ '19.2.0' ]
npm ERR! gyp verb install input version string "19.2.0"
npm ERR! gyp verb install installing version: 19.2.0
npm ERR! gyp verb install --ensure was passed, so won't reinstall if already installed
npm ERR! gyp verb install version is already installed, need to check "installVersion"
npm ERR! gyp verb got "installVersion" 9
npm ERR! gyp verb needs "installVersion" 9
npm ERR! gyp verb install version is good
npm ERR! gyp verb get node dir target node version installed: 19.2.0
npm ERR! gyp verb build dir attempting to create "build" dir: C:\Users\denis\OneDrive\Documents\Website\node_modules\node-sass\build
npm ERR! gyp verb build dir "build" dir needed to be created? Yes
npm ERR! gyp verb find VS msvs_version was set from command line or npm config
npm ERR! gyp verb find VS - looking for Visual Studio version 2022
npm ERR! gyp verb find VS running in VS Command Prompt, installation path is:
npm ERR! gyp verb find VS "C:\Program Files (x86)\Microsoft Visual Studio\2022\Community"
npm ERR! gyp verb find VS - will only use this version
npm ERR! gyp verb find VS checking VS2022 (17.4.33122.133) found at:
npm ERR! gyp verb find VS "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools"
npm ERR! gyp verb find VS - found "Visual Studio C++ core features"
npm ERR! gyp verb find VS - found VC++ toolset: v143
npm ERR! gyp verb find VS - missing any Windows SDK
npm ERR! gyp verb find VS could not find a version of Visual Studio 2017 or newer to use
npm ERR! gyp verb find VS looking for Visual Studio 2015
npm ERR! gyp verb find VS - not found
npm ERR! gyp verb find VS not looking for VS2013 as it is only supported up to Node.js 8
npm ERR! gyp ERR! find VS
npm ERR! gyp ERR! find VS msvs_version was set from command line or npm config
npm ERR! gyp ERR! find VS - looking for Visual Studio version 2022
npm ERR! gyp ERR! find VS running in VS Command Prompt, installation path is:
npm ERR! gyp ERR! find VS "C:\Program Files (x86)\Microsoft Visual Studio\2022\Community"
npm ERR! gyp ERR! find VS - will only use this version
npm ERR! gyp ERR! find VS checking VS2022 (17.4.33122.133) found at:
npm ERR! gyp ERR! find VS "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools"
npm ERR! gyp ERR! find VS - found "Visual Studio C++ core features"
npm ERR! gyp ERR! find VS - found VC++ toolset: v143
npm ERR! gyp ERR! find VS - missing any Windows SDK
npm ERR! gyp ERR! find VS could not find a version of Visual Studio 2017 or newer to use
npm ERR! gyp ERR! find VS looking for Visual Studio 2015
npm ERR! gyp ERR! find VS - not found
npm ERR! gyp ERR! find VS not looking for VS2013 as it is only supported up to Node.js 8
npm ERR! gyp ERR! find VS msvs_version does not match this VS Command Prompt or the
npm ERR! gyp ERR! find VS installation cannot be used.
npm ERR! gyp ERR! find VS
npm ERR! gyp ERR! find VS **************************************************************
npm ERR! gyp ERR! find VS You need to install the latest version of Visual Studio
npm ERR! gyp ERR! find VS including the "Desktop development with C++" workload.
npm ERR! gyp ERR! find VS For more information consult the documentation at:
npm ERR! gyp ERR! find VS https://github.com/nodejs/node-gyp#on-windows
npm ERR! gyp ERR! find VS **************************************************************
npm ERR! gyp ERR! find VS
npm ERR! gyp ERR! configure error
npm ERR! gyp ERR! stack Error: Could not find any Visual Studio installation to use
npm ERR! gyp ERR! stack     at VisualStudioFinder.fail (C:\Users\denis\OneDrive\Documents\Website\node_modules\node-gyp\lib\find-visualstudio.js:122:47)  
npm ERR! gyp ERR! stack     at C:\Users\denis\OneDrive\Documents\Website\node_modules\node-gyp\lib\find-visualstudio.js:75:16
npm ERR! gyp ERR! stack     at VisualStudioFinder.findVisualStudio2013 (C:\Users\denis\OneDrive\Documents\Website\node_modules\node-gyp\lib\find-visualstudio.js:363:14)
npm ERR! gyp ERR! stack     at C:\Users\denis\OneDrive\Documents\Website\node_modules\node-gyp\lib\find-visualstudio.js:71:14
npm ERR! gyp ERR! stack     at C:\Users\denis\OneDrive\Documents\Website\node_modules\node-gyp\lib\find-visualstudio.js:384:16
npm ERR! gyp ERR! stack     at C:\Users\denis\OneDrive\Documents\Website\node_modules\node-gyp\lib\util.js:54:7
npm ERR! gyp ERR! stack     at C:\Users\denis\OneDrive\Documents\Website\node_modules\node-gyp\lib\util.js:33:16
npm ERR! gyp ERR! stack     at ChildProcess.exithandler (node:child_process:427:5)
npm ERR! gyp ERR! stack     at ChildProcess.emit (node:events:513:28)
npm ERR! gyp ERR! stack     at maybeClose (node:internal/child_process:1098:16)
npm ERR! gyp ERR! stack     at ChildProcess._handle.onexit (node:internal/child_process:304:5)
npm ERR! gyp ERR! System Windows_NT 10.0.22621
npm ERR! gyp ERR! command "C:\\Program Files\\nodejs\\node.exe" "C:\\Users\\denis\\OneDrive\\Documents\\Website\\node_modules\\node-gyp\\bin\\node-gyp.js" "rebuild" "--verbose" "--libsass_ext=" "--libsass_cflags=" "--libsass_ldflags=" "--libsass_library="
npm ERR! gyp ERR! cwd C:\Users\denis\OneDrive\Documents\Website\node_modules\node-sass
npm ERR! gyp ERR! node -v v19.2.0
npm ERR! gyp ERR! node-gyp -v v8.4.1
npm ERR! gyp ERR! not ok
npm ERR! Build failed with error code: 1

相关截图说明 #

• 系统信息：显示当前系统为Windows 10 22621版本
• 已安装组件：确认安装了Visual Studio 2022 Build Tools及Windows 11 SDK
• 环境变量：系统路径中已添加VCINSTALLDIR
• VS Code输出：显示Python版本为3.11.0，msvs_version配置为2022

解决建议 #

1. 补装对应版本的Windows SDK #

错误日志明确提示missing any Windows SDK，当前系统是Windows 10 22621，需安装Windows 10 SDK 10.0.22621.0（与系统版本匹配）。打开Visual Studio Installer，选择修改Build Tools，在“单个组件”中找到对应版本的Windows SDK并勾选安装。

2. 手动指定msvs_version和MSBuild路径 #

执行以下命令配置npm，强制指定使用VS2022：

npm config set msvs_version 2022
npm config set msbuild_path "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe"

之后重新执行：

npm install --force

或者直接在install命令中指定：

npm install --force --msvs_version=2022

3. 降级Python版本 #

node-gyp@8.4.1对Python 3.11的兼容性不佳，建议降级到Python 3.10.x版本，然后配置npm指向新的Python路径：

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

4. 使用Visual Studio开发者命令行执行 #

以管理员身份打开Visual Studio 2022 Developer Command Prompt，切换到项目目录后再执行npm install --force，该命令行已自动配置好所有VS相关环境变量，避免手动配置遗漏。

5. 清理缓存后重试 #

先清理npm缓存和旧依赖，再重新安装：

npm cache clean --force
rmdir /s /q node_modules
del package-lock.json
npm install --force

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