this.getOptions is not a function 错误源于 sass-loader 与 Webpack 版本不匹配：Webpack 4 需 sass-loader@8–10 + node-sass@4.14.1，Webpack 5 需 sass-loader@12–13 + sass（Dart Sass），三者必须严格对齐。
this.getOptions is not a function 这类错误不是 Sass 代码写错了，而是 sass-loader 和它依赖的运行时环境（主要是 Webpack + Sass 实现）根本没对上号。直接降级或重装往往治标不治本，关键得让三者版本彼此“认得出来”。
查清当前项目的真实依赖链
别猜，先看实际装了什么。执行这行命令能暴露所有隐藏冲突：
npm list sass-loader css-loader webpack node-sass sass
重点核对三点：
-
webpack版本：Vue CLI 4 对应 Webpack 4，CLI 5+ 对应 Webpack 5 —— 这是决策起点 -
sass-loader主版本是否匹配 Webpack：Webpack 4 只认sass-loader@8–10，Webpack 5 要@12–13 -
node-sass或sass是否共存：两者不能同时存在，node-sass已归档，sass（Dart Sass）是唯一推荐实现
Webpack 4 项目遇到 getOptions 报错
这是最常见场景：Vue CLI 4 升级后误装了新版 sass-loader。Webpack 4 的 loader API 没有 this.getOptions 方法，新版 loader 直接调用就崩。
立即学习“前端免费学习笔记（深入）”；
- 卸载当前
sass-loader：npm uninstall sass-loader --save-dev - 装回兼容版：
npm install sass-loader@10.4.2 --save-dev（@10.x是 Webpack 4 最终稳定版） - 配套 Sass 实现必须用
node-sass@4.14.1（sass不支持 Webpack 4）：npm install node-sass@4.14.1 --save-dev - 删掉
node_modules和package-lock.json后重装，避免残留引用
Webpack 5 项目编译失败或提示 node-sass 不支持
Webpack 5 默认要求 Dart Sass，且 node-sass 在 Node.js 16+ 已彻底不可用。报错如 Node Sass does not yet support your current environment 就是典型信号。
- 立刻移除
node-sass：npm uninstall node-sass --save-dev - 安装
sass：npm install sass --save-dev -
sass-loader选@12.6.0或@13.3.2（当前 Webpack 5 稳定组合）：npm install sass-loader@13.3.2 --save-dev - 不用改 Webpack 配置 ——
sass-loader会自动识别sass包，node-sass的includePaths选项在sass中对应为loadPaths，如有自定义路径需同步调整
为什么锁死版本比用 ^ 更可靠
很多人忽略 package.json 里 ^sass-loader@12.0.0 的风险：下次 npm install 可能拉下 12.9.0，而这个小版本可能悄悄要求 Node.js 18，但你的 CI 服务器只装了 Node.js 16。
- 生产项目建议用精确版本：
"sass-loader": "13.3.2"，不带^或~ - CI/CD 流程中加一行检查：
npm list sass-loader | grep -q "13.3.2"，防止意外升级 - 团队协作时，
package-lock.json必须提交 —— 它才是真实安装依据，不是package.json
真正麻烦的从来不是装哪个版本，而是不同机器、不同时间点装出来的版本不一致。环境对齐的第一步，是让所有人看到同一棵树，而不是各自对着一片森林瞎猜。
