PAYATHON 2026

Angular 22.2 升级后 Sass 在 FreeBSD 流水线卡住

数据小陈

结论:Angular CLI 并没有稳定公开的 --use-sass-js 这类开关来切换 Sass 实现,构建器一般会根据依赖解析结果选择 sass-embedded 或 sass。在 Angular 22.2 的 FreeBSD runner 上,优先让项目解析不到 sass-embedded,并显式安装纯 JS 的 sass。如果 @angular-devkit/build-angular 硬依赖 sass-embedded,就不要强行做 alias,改用 Linux runner 或回退到 22.1.x 会更稳。

原因:sass-embedded 依赖 Dart Sass 的原生/embedded 运行方式,FreeBSD 上不一定有可用的预编译二进制;纯 JS 的 sass 包也不支持 sass --embedded 这个入口。日志 sass --embedded is unavailable in pure JS mode. 说明构建路径正在尝试 embedded 协议。之后往往没有更多输出,表现通常是子进程等待或卡住。Windows 本地正常,一般是因为 embedded 二进制可用,或者走了不同的解析路径。

操作步骤:

  1. 先确认实际依赖树和 CLI 版本:
npx ng version
npm ls sass sass-embedded
  1. 安装纯 JS 的 sass,并移除项目直接依赖的 sass-embedded:
npm install --save-dev sass@^1.77.0
npm uninstall sass-embedded

如果 npm ls sass-embedded 仍显示它来自 @angular-devkit/build-angular 的传递依赖,先看它是不是 optional:

npm ls sass-embedded
npm install --omit=optional

--omit=optional 会影响所有 optional dependency,CI 中要确认没有其他必要包被跳过。

  1. 若必须处理传递依赖,可在 package.json 里用 overrides 做定向替换。这一步有风险,只在确认 API 兼容时用:
{
  "overrides": {
    "sass-embedded": "npm:sass@^1.77.0"
  }
}

改完后清理安装:

rm -rf node_modules package-lock.json
npm install
  1. 用详细日志确认是否还走 embedded:
CI=true npx ng build --base-href=/ui/ --verbose

如果仍然卡住,可先把构建 worker 降到 1,排除并发或资源问题:

NG_BUILD_MAX_WORKERS=1 CI=true npx ng build --base-href=/ui/ --verbose
  1. 如果 22.2 的构建器硬要用 sass-embedded,而你的 FreeBSD 环境又无法提供可用二进制,最稳妥的是回退 Angular 工具链到 22.1.x,或把 CI runner 换成官方支持更好的 Linux 镜像。回退时保持 @angular/cli、@angular/core、@angular-devkit/build-angular 等版本匹配。

注意:angular.json 里的 stylePreprocessorOptions 主要传 Sass 编译选项,不是切换 Sass 实现的开关;不要靠直接删 node_modules/sass-embedded 解决,因为 npm ci 会重新装回来。验证是否生效,重点看 npm ls sass-embedded 是否为空,以及构建日志里是否还出现 sass --embedded。

备注:内容仅供参考。