Parcel+Sass构建报错：@parcel/transformer-sass安装/找不到模块问题求助

云原生阿岚

2026-9-28

你遇到的问题由两个常见错误共同导致：Parcel核心包与插件版本不兼容、插件包名拼写错误，按以下步骤操作即可解决：

清理项目残留文件
删除项目根目录下的node_modules文件夹、package-lock.json锁文件、以及自动生成的.parcel-cache缓存文件夹。
修正依赖配置
@parcel/transformer-sass和@parcel/config-default均为开发依赖，不需要放在dependencies中，且所有Parcel官方插件必须与本地安装的parcel核心包版本完全一致。
修改你的package.json的依赖段为如下配置：
```
"devDependencies": {
  "parcel": "^2.12.0",
  "@parcel/transformer-sass": "^2.12.0"
},
"dependencies": {
  "@popperjs/core": "^2.10.2",
  "bootstrap": "^5.1.3",
  "bootstrap-table": "^1.18.3",
  "jquery": "^3.6.0"
}
```
注：你之前执行的npm i @parcel/transformer-scss属于错误命令，官方不存在名为@parcel/transformer-scss的包，正确包名为@parcel/transformer-sass，同时支持.scss和.sass两种格式的文件处理。
删掉自定义.parcelrc文件
Parcel默认的配置已经内置了对.scss/.sass格式的处理规则，不需要额外配置。你之前的配置中错误将插件名写为@parcel/transformer-scss，反而会导致模块查找失败。
重新安装依赖并构建
执行以下命令重新安装依赖：
```
npm install
```
安装完成后执行构建命令验证：
```
npm run build
```