WSL环境安装含node-sass的应用时make报错退出码2如何解决？

核心根因 #

报错由两个常见问题共同导致：

1. node-sass与Node.js版本不兼容：你使用的Node.js 16.x仅支持node-sass v7.0及以上版本，低于该版本的node-sass无法在Node.js 16环境下编译通过
2. WSL跨文件系统兼容问题：你把项目存放在/mnt/c对应的Windows原生分区下，WSL访问该分区时存在权限、文件锁、符号链接兼容缺陷，会导致node-gyp编译过程异常中断

解决方案（按优先级排序） #

方案一：替换node-sass为官方兼容替代dart-sass（推荐，永久解决问题） #

dart-sass是node-sass官方推荐的平替方案，完全兼容sass语法，不需要二进制编译，可彻底避开编译报错

• 第一步：清理现有依赖和缓存

rm -rf node_modules package-lock.json yarn.lock
npm cache clean --force
# 若使用yarn作为包管理器，额外执行 yarn cache clean

• 第二步：修改package.json配置，强制替换依赖
  在package.json中新增resolutions字段，同时在scripts中新增前置安装脚本：

{
  "scripts": {
    "preinstall": "npx npm-force-resolutions",
    // 保留你原有其他scripts内容
  },
  "resolutions": {
    "node-sass": "npm:dart-sass@^1.25.0"
  },
  // 保留你原有其他package.json内容
}

• 第三步：重新执行依赖安装即可

方案二：修复版本匹配问题 #

若项目不允许替换node-sass，可调整版本匹配关系：

• 若可以升级node-sass：将package.json中的node-sass版本升级到v7.0+，清理缓存后重新安装
• 若不能升级node-sass：使用nvm将Node.js版本降到14.x，再重新安装依赖

方案三：修复WSL文件系统问题 #

不要将项目存放在/mnt/c对应的Windows分区下，将项目迁移到WSL原生Linux文件系统（例如/home/你的用户名/目录下），再重新克隆项目安装依赖，可解决绝大多数WSL下的node-gyp编译报错

方案四：补全编译依赖 #

若必须将项目放在Windows分区下，先安装完整的编译工具链再重试：

sudo apt update
sudo apt install build-essential python2
# 给node-gyp指定python2版本
npm config set python /usr/bin/python2

清理缓存后重新执行依赖安装即可

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