React项目编译失败：@mui/system未导出colorChannel

开发者阿泽

2026-8-22

解决方法

这个错误是由于@mui/material和@mui/system版本不匹配导致的，以下是具体修复步骤：

统一MUI包版本
1. 先查看当前已安装的版本：
```
npm list @mui/material @mui/system
```
  （使用yarn的话换成yarn list @mui/material @mui/system）
2. 卸载现有不兼容的包：
```
npm uninstall @mui/material @mui/system
```
3. 重新安装同版本的稳定包，比如最新版：
```
npm install @mui/material@latest @mui/system@latest
```
  也可以指定具体的兼容版本，例如@mui/material@5.14.0 @mui/system@5.14.0
清除依赖缓存并重装
如果版本统一后仍报错，试试清理缓存：
1. 清除npm缓存：
```
npm cache clean --force
```
2. 删除node_modules和锁文件：
```
rm -rf node_modules package-lock.json
```
  Windows系统执行：
```
rmdir /s /q node_modules && del package-lock.json
```
3. 重新安装所有依赖：
```
npm install
```
强制指定@mui/system版本
如果有第三方依赖偷偷引入了旧版本的@mui/system，在package.json中添加overrides字段强制统一版本：
```
"overrides": {
  "@mui/system": "^5.14.0"
}
```
yarn用户换成resolutions字段：
```
"resolutions": {
  "@mui/system": "^5.14.0"
}
```