直接卸载 node-sass、安装 sass 后，90% 项目可运行，但剩余 10% 存在路径、除法、@import 和深度选择器四类兼容性问题；需升级 sass-loader 版本、修正语法并启用缓存。
直接卸载 node-sass、安装 sass，90% 的项目就能跑起来——但剩下那 10% 的“能跑”不等于“没坑”，关键在路径、除法、@import 和深度选择器这四点。
为什么 npm uninstall node-sass && npm install sass --save-dev 不够用
因为 sass（Dart Sass）不是 node-sass 的“升级版”，而是语言规范的官方实现。它严格遵循 Sass spec，而 node-sass（LibSass）曾长期存在兼容性妥协。迁移后常见现象包括：
-
SassError: expected selector—— 多半是/deep/或>>>深度选择器写法被拒绝 - 颜色计算或除法报错，比如
10px / 2在 LibSass 中默认当除法，在 Dart Sass 中会被当成 CSS 除法（需加括号：(10px / 2)） -
@import路径里用了相对路径但没加.scss后缀，Dart Sass 不再自动补全 - Windows 下路径分隔符
\被当成转义字符，导致@use "utils\mixins"解析失败
sass-loader 版本必须匹配 sass API
sass-loader 是 Webpack 与 Sass 编译器之间的胶水，它对底层编译器有明确适配要求。若你用的是 Webpack 5+，必须用 sass-loader@^12.0.0 或更高；Vue CLI 4/5 默认已适配，但老项目常卡在 sass-loader@8.x，它只认 node-sass 的回调签名。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 检查当前版本：
npx sass --version（应为1.77.x或更新） - 对应升级：
npm install sass-loader@^12.6.0 --save-dev - 若项目仍用 Webpack 4，可降级到
sass-loader@10.4.2（最后支持 Webpack 4 的兼容版本） - 注意：旧版
sass-loader配置中implementation字段若指向require('node-sass')，必须删掉或改为require('sass')
Vue 项目里 /deep/ 和 ::v-deep 怎么处理
这不是 Sass 的问题，而是 Vue 的 scoped 样式机制和 Dart Sass 解析器的叠加效应。/deep/ 是非标准语法，Dart Sass 直接当无效 selector 报错；::v-deep 是伪类，但 Vue 2 的 vue-loader 会把它转成普通 class，而 Dart Sass 不允许伪类出现在 @import 或嵌套块里。
- 最稳妥方案：改用
:deep()（Vue 3）或>>>+vue-loader@15.9+（Vue 2） - 临时绕过：把含深度选择器的样式块单独抽成普通 CSS 文件，用
src引入，避开 Sass 解析 - 别用
@import "xxx.scss" // 包含 ::v-deep—— Dart Sass 会在解析阶段就报错，根本进不了 vue-loader
构建变慢？别急着回退，先看内存和缓存
Dart Sass 纯 JS 实现，冷启动确实比 LibSass 慢一点，但热更新和增量编译反而更稳。如果你发现构建时间明显上涨，大概率是以下两个原因：
- 没开 Sass 缓存：
sass-loader配置里加cache: true（Webpack 5+ 默认开启，但老配置可能关着） - 内存不足触发 GC：
sass占用内存比node-sass高，Node.js 默认内存限制（~1.4GB）下容易卡顿，可加启动参数：node --max-old-space-size=4096 node_modules/.bin/vue-cli-service build - 真正要警惕的是“每次改一个变量，全量重编译”——这说明你没用
@use模块系统，还在靠@import全局污染，重构时优先把variables.scss改成@use "variables" as var
迁移真正的复杂点不在命令行那两行，而在你项目里那些“一直能用所以没人动过”的 _mixins.scss 和 base/_reset.scss —— 它们往往藏着 LibSass 特有的除法写法、隐式字符串拼接、甚至自定义函数返回值类型误用。建议先跑一遍 npx sass --dry-run src/styles（需 Sass 1.70+），让编译器提前暴露语法问题，比等 CI 报错再查快得多。
