node-sass 4.14 在 Node 18 环境一直报错 改成 dart-sass 怎么配

现象

老项目在 Node 18 下 npm install,node-sass 4.14 进入编译阶段就失败,日志结尾是 gyp ERR! build error,前面还有 node-pre-gyp 找不到预编译包的提示。补装 Python 和 VS Build Tools,重跑仍然是同一处失败。

原因

node-sass 依赖 libsass 的本地二进制,每个 Node 大版本都要对应的预编译产物。4.14 只覆盖到 Node 14 左右,Node 18 不在它的下载清单里,只能回退到源码编译,而新版 C++ 工具链又和它的 binding.gyp 不兼容,于是必然失败。

解决步骤

第一步,确认版本对应关系,不要盲目补编译环境。

node -v
npm ls node-sass
npm view node-sass@4.14.1 engines

第二步,换掉 node-sass。把依赖改成 sass(即 dart-sass),它纯 JS 实现、无需本地编译,语法和常用 API 基本兼容;再把构建脚本里对 node-sass 的引用替换为 sass,删掉 lock 文件重新安装。

第三步,暂时不能换时降 Node 版本。用 nvm 切到 Node 14 装完依赖,或在包管理器里配置镜像下载预编译产物;这只是拖延方案,仍建议排期迁移。

验证

npm install 不再出现 gyp 日志,构建时 scss 能正常编译,产物 CSS 与改造前对比无明显差异,说明替换成功。

小结

node-sass 的版本矩阵很窄,Node 一升级就断。官方早已建议迁移到 dart-sass,早换比每次补编译环境省事。

您可以还会对下面的文章感兴趣: