根本原因是 binding.node 文件与 Node ABI 版本不匹配且国内无法稳定下载，正确解法是彻底替换为 sass（Dart Sass）：先卸载 node-sass 和 sass-loader，再安装 sass 与 sass-loader@^13，清除缓存并修正配置中 implementation 和 nodeSass 字段。
node-sass 安装报错根本不是网络或权限问题
它卡在 binding.node 文件下载或本地编译上，而这个文件必须和当前 Node 的 ABI 版本（process.versions.modules 值）严格匹配。Node 16 → ABI 93，Node 18 → ABI 108，Node 20 → ABI 115，Node 22 → ABI 120 —— node-sass@6 根本不认 ABI 108，node-sass@7 不支持 ABI 93，装了也白装。
更麻烦的是：国内访问 s3.amazonaws.com 托管的预编译包极不稳定，常 404 或超时；fallback 编译又要求 Python + Visual Studio Build Tools（Windows）或 Xcode Command Line Tools（macOS），稍有缺失就报 gyp ERR! 或 python not found。
切换到 sass（Dart Sass）只需三步，但顺序不能错
这不是“升级”，是彻底替换。残留 node-sass 会导致 sass-loader 优先加载旧实现，新包形同虚设。
- 卸载两个包：
npm uninstall node-sass sass-loader（注意：必须连sass-loader一起卸，避免版本冲突） - 重装新组合：
npm install -D sass sass-loader@^13（sass-loader@13.3.2是 Webpack 5 最稳版本） - 删干净缓存：
rm -rf node_modules package-lock.json，再npm install（否则旧require('node-sass')路径可能被复用）
sass-loader 配置里最容易漏掉的坑
sass-loader 默认会自动找 sass 包，但前提是没被显式覆盖。很多项目在 vue.config.js、webpack.config.js 或 next.config.js 里硬写了：
implementation: require('node-sass')
这种写法必须删掉，或者改成：
生成Blender Python (bpy)脚本，该脚本使用node_groups API和GeometryNodeTree接口程序化地创建几何节点修改器树，用于参数化3D资产生成。
implementation: require('sass')
另外检查是否有 nodeSass 字段（Vue CLI 旧配置常见），它会强制降级回 node-sass，哪怕你已经装了 sass。
切完之后编译报错？大概率是语法变严格了
Dart Sass 不再宽容处理错误语法，原来被 node-sass 忽略的问题会立刻暴露：
-
@import全部要换成@use，且@use必须在文件最顶部，不能嵌套、不能加v-if - 变量作用域收紧：未
@use就引用$color-primary→ 报Undefined variable -
& :hover中的空格非法，必须写成&:hover -
.sass（缩进语法）默认不支持，得先统一转成.scss后缀
真正卡住的往往不是命令执行失败，而是 CI 流水线里缓存了旧 node_modules，或者某处 loader 插件悄悄劫持了 sass-loader 的输出链路 —— 这些地方不手动翻一遍，sass 就永远只是个躺在 node_modules 里的摆设。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
