文章内容

2025/10/26 20:25:06,作 者: 黄兵

Error: Node Sass does not yet support your current environment: Windows 64-bit with Unsupported runtime (127)

最近升级了 Node.js 导致项目的 Node-sass 出现错误,具体错误内容:

Module build failed (from ./node_modules/sass-loader/dist/cjs.js): Error: Node Sass does not yet support your current environment: Windows 64-bit with Unsupported runtime (127)

出现问题原因:

通常意味着你的项目中所用的 node‑sass 版本与当前安装的 Node.js 运行时版本不兼容。

✅ 常见原因
  1. node-sass 编译的二进制绑定(bindings)与当前 Node.js 的 ABI 版本不匹配(“Unsupported runtime (127)” 表示 node 模块 ABI 与当前 node 运行时不一致)。

  2. 你的 Node.js 版本过高,而 node-sass 版本尚未支持该版本。

  3. 如果刚刚升级了 Node.js,那么 node_modules 中已有的二进制没有重新编译。

🛠 解决步骤

以下按从轻到重整理,你可以逐项试:

  1. 清除缓存 + 删除模块 + 重新安装

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

    这一步可排除因残留旧模块造成的问题。

  2. 强制重建 node-sass

    npm rebuild node-sass --force
    

    如果只是 Node 版本升级但 node-sass 版本仍支持当前 Node,此步即可修复。

  3. 升级或降级 node-sass 与 Node.js 以确保版本兼容

    • 首先查看你当前 Node.js 版本:node -v

    • 查看你使用的 node-sass 版本:npm ls node-sass

    • 在 node-sass 的 GitHub 或 npm 页面查找“Supported environments / Node versions”兼容表。

    • 如果你的 Node 版本太高,而 node-sass 版本旧:可以升级 node-sass 到兼容的版本。

    • 如果你必须使用旧的 node-sass 版本,则可能需要降级 Node.js 到一个受支持的版本。比如一些老项目用 Node.js 14 或 12。

  4. 迁移到 sass(Dart Sass)替代 node-sass
    note:node-sass 已经逐渐被弃用,社区建议迁移。你可以:

    npm uninstall node-sass
    npm install --save-dev sass
    

    并在 sass-loader 配置中将 implementation: require("sass")(如果使用 webpack)等。

分享到:

发表评论

评论列表