Apple M1芯片下Node与Sass的Ionic项目启动报错问题

1. 更新node-gyp版本 #

你的node-gyp版本为v3.8.0，与Node.js 14兼容性较差，先更新到最新版：

npm install -g node-gyp@latest

随后清理缓存并重新安装依赖：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

2. 配置node-sass二进制包镜像 #

node-sass安装时需下载对应系统的二进制包，网络问题可能导致失败，设置国内镜像源：

npm config set sass_binary_site=https://npm.taobao.org/mirrors/node-sass/

完成后重新执行依赖安装命令。

3. 替换node-sass为dart-sass #

node-sass已停止维护，dart-sass是官方推荐的替代方案，兼容性更强。修改项目package.json，将node-sass依赖替换为sass，然后执行：

rm -rf node_modules package-lock.json
npm install

4. 安装系统编译依赖 #

node-gyp编译需要系统级工具，根据你的操作系统安装对应组件：

• Windows：以管理员权限执行npm install --global windows-build-tools
• macOS：执行xcode-select --install安装Xcode命令行工具
• Linux（如Ubuntu）：执行sudo apt-get install build-essential安装gcc、g++、make等编译工具

5. 调整Node.js子版本 #

Node.js 14的部分最新子版本可能与node-sass@4.14.1存在兼容性问题，建议切换到Node.js 14的稳定子版本（如v14.19.0）后再尝试安装。

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