升级node-sass后遇SassError：red($color)参数必须为颜色类型求助

错误原因分析 #

这个报错是因为Bootstrap的to-rgb函数接收到了非颜色类型的参数，触发了red($color)函数的参数校验失败。核心原因通常是node-sass与Bootstrap版本不兼容，或者自定义的颜色变量存在非法取值。

具体解决步骤 #

• 更换为Dart Sass（推荐方案）
  node-sass已经停止维护，Bootstrap 5及后续版本不再支持node-sass，建议直接切换到官方推荐的Dart Sass：

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

  安装完成后重新启动项目，大部分兼容性问题都能解决。

• 检查自定义颜色变量
  打开src/assets/scss/config/default/bootstrap.scss，查看你自定义的Bootstrap根变量（比如$primary、$success等），确保所有颜色相关变量都是合法的Sass颜色值——比如十六进制#165DFF、RGB值rgb(22,93,255)、内置颜色名blue这类，避免传入字符串、未定义变量或其他非颜色类型的值。

• 清理编译缓存
  缓存残留可能导致旧的错误状态持续，执行以下命令重置缓存后重启项目：

  npm start -- --reset-cache
  

  也可以手动删除项目根目录下的node_modules/.cache文件夹，再重新编译。

内容的提问来源于stack exchange，提问作者Fidaali Vohra