执行npm install时出现node-sass、python2等多个错误如何解决

根因说明 #

这类报错主要由两类问题触发：

1. node-sass为依赖原生C++模块的包，不同Node大版本与node-sass版本存在严格对应关系，Node16不兼容v6.0.0以下的node-sass版本
2. Windows环境下缺少原生模块编译所需的python2、Visual Studio构建工具，导致node-sass编译失败

分步解决步骤 #

方案一：官方推荐替换弃用的node-sass（优先选择） #

node-sass已在2020年正式宣布废弃，官方推荐使用无原生依赖的dart-sass（包名已改为sass），兼容性更好无需编译，操作如下：

• 卸载现有node-sass依赖：npm uninstall node-sass
• 安装新版sass：npm install sass --save-dev
  绝大多数前端脚手架（Vue CLI、Create React App等）和业务代码无需额外修改即可直接适配。

方案二：必须保留node-sass的处理方式 #

• 首先确认版本匹配：Node16.13.0对应的最低兼容node-sass版本为v6.0.1，检查package.json中node-sass的版本号，若低于该值执行安装对应版本：npm install node-sass@6.0.1 --save-dev
• 若版本匹配后仍报python2、编译相关错误，以管理员身份启动CMD/PowerShell执行安装Windows构建工具：npm install -g windows-build-tools，该命令会自动安装python2.7、Visual Studio构建工具等依赖，安装完成后重启终端重新执行npm install即可。

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