Windows环境下项目缺失node_modules，npm install因node-sass编译失败如何解决？

方案1：替换已废弃的node-sass（优先推荐） #

node-sass已停止维护，对Node版本、Windows编译环境兼容性极差，替换为纯JS实现的sass包可从根本解决问题，操作步骤如下：

• 删除项目目录下的package-lock.json文件、node_modules目录（如有残留）
• 打开package.json，将dependencies节点下的"node-sass": "^4.13.1"配置删除，替换为"sass": "^1.32.0"
• 执行缓存清理命令：

npm cache clean --force

• 重新执行依赖安装：

npm install

该方案适配你项目中react-scripts@3.4.1的版本要求，不会影响原有sass代码的编译逻辑。

方案2：保留node-sass，修复编译环境 #

如果必须保留原有node-sass依赖，可按以下步骤排查修复：

步骤1：适配Node版本 #

node-sass@4.13.1最高仅支持Node.js 13.x版本，若你当前使用的Node版本≥14，会直接触发编译失败，可使用nvm切换Node版本至12.x LTS版本后再尝试安装。

步骤2：修复C++编译环境 #

你报错中的MSB4019错误是因为缺少Visual Studio C++编译组件，windows-build-tools包在新Windows系统中经常安装失败，建议手动安装：

• 打开Visual Studio Installer，安装「使用C++的桌面开发」工作负载，必须勾选对应版本的Windows SDK、MSVC v142及以上版本生成工具
• 执行命令配置node-gyp的VS版本（根据你安装的VS版本调整，2019就填2019，2022就填2022）：

npm config set msvs_version 2019

• 重新执行npm install

其他报错说明 #

你在上级目录执行npm start触发的JScript编译错误，是因为执行命令时不在项目根目录，Windows系统将tailwind.js识别为系统脚本而非Node脚本执行导致，后续所有命令均在项目根目录（cp-frontend文件夹下）执行即可避免该问题。

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