Windows11装VS2022企业版安装node-sass报gyp错误如何解决

错误原因 #

1. msvs_version参数配置错误：该参数需要传入Visual Studio的版本号而非安装路径，你填写的路径无法被node-gyp识别，才会出现unknown version "undefined"的报错。
2. node-gyp版本过低：你当前依赖的node-gyp@7.1.2版本发布早于Visual Studio 2022正式版，原生不支持VS2022的识别逻辑。
3. 可额外排查node-sass与Node.js的版本匹配问题：node-sass对Node.js版本有严格的对应要求，版本不匹配也会触发编译报错。

解决方案 #

按顺序执行以下操作即可：

1. 先删除错误的npm配置项：

npm config delete msvs_version
npm config delete msbuild_path

2. 配置正确的VS版本参数：

npm config set msvs_version 2022

3. 升级全局node-gyp到最新版本，适配VS2022：

npm install -g node-gyp@latest

4. 清理项目缓存：删除项目根目录下的node_modules文件夹、package-lock.json文件后，执行缓存清理命令：

npm cache clean --force

5. 重新执行安装命令：

npm install node-sass --save-dev

备选最优方案 #

node-sass已被官方废弃，且依赖本地编译环境，非常容易出现环境兼容问题。你可以直接替换为纯JavaScript实现的sass包，无需本地编译，完全兼容node-sass的所有常用API，项目原有sass代码不需要做任何修改，执行以下命令直接替换即可：

npm install sass --save-dev

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