Windows下npm安装依赖报错：无法找到可用Visual Studio安装

• node-sass@7.0.1 仅支持 Node.js 12.x-16.x 版本，你当前使用的 Node.js v20.16.0 超出兼容范围，直接导致构建失败。
• Python 3.13.0 属于较新版本，node-gyp 暂未完全适配，其推荐的稳定版本为 Python 3.7-3.11。
• 即使安装了 Visual Studio 相关组件，也可能因环境变量未正确配置，导致 node-gyp 无法识别到有效的 Visual Studio 安装路径。

1. 调整 Node.js 版本到兼容范围 #

使用 nvm（Node 版本管理器）切换至 node-sass@7.0.1 支持的最高 Node.js 版本（v16.x）：

nvm install 16.20.2
nvm use 16.20.2

切换完成后重新执行 npm install。

2. 更换适配的 Python 版本 #

卸载 Python 3.13.0，安装 Python 3.11.x 版本，安装时务必勾选「Add Python to PATH」选项。安装完成后执行 python --version 确认版本生效。

3. 配置 Visual Studio 环境变量 #

• 打开 Visual Studio Installer，确认已安装「Desktop development with C++」工作负载，包含 Windows SDK 和 MSVC 构建工具。
• 以管理员身份打开命令提示符，执行以下命令指定 Visual Studio 版本：

npm config set msvs_version 2022

• 若上述命令无效，可手动添加环境变量 VS2022INSTALLDIR，指向你的 Visual Studio 安装路径（例如 C:\Program Files\Microsoft Visual Studio\2022\Community）。

4. 替换 node-sass 为 sass（dart-sass） #

如果不想调整 Node.js 和 Python 版本，可将项目依赖的 node-sass 替换为官方推荐的 sass（dart-sass），它无需 node-gyp 构建，兼容性更强：

npm uninstall node-sass
npm install sass

注意：需检查项目代码中是否依赖 node-sass 特定 API，大部分场景下两者 API 兼容，仅需小幅调整。

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