You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

执行npm start时出现@material-ui/system未导出styleFunctionSx的导入错误求助

解决Material UI Box组件导入styleFunctionSx失败的问题

这个问题我之前踩过一模一样的坑,折腾了好一会儿才搞定,给你说说根源和解决办法:

根本原因

  • 版本不匹配:这是最常见的情况。styleFunctionSx是@material-ui/system包提供的API,当你项目里的@material-ui/core和@material-ui/system版本不一致时,就会出现找不到导出的错误。比如你装了@material-ui/core v5.x,但@material-ui/system还停留在v4.x,或者反过来,两个包的依赖逻辑对不上就会触发这个问题。
  • 版本过旧:如果你的Material UI相关包版本太老,@material-ui/system里根本还没加入styleFunctionSx这个导出,自然会报错。

解决方法

1. 统一Material UI相关包的版本

先卸载现有不匹配的包:

npm uninstall @material-ui/core @material-ui/system

然后重新安装版本一致的包,推荐安装最新稳定版(如果需要指定版本,确保两个包版本号完全相同):

npm install @material-ui/core @material-ui/system

用Yarn的话,替换成对应的Yarn命令即可。

2. 清除缓存并重新构建

有时候npm缓存会残留旧版本的依赖文件,导致版本不一致,执行以下步骤彻底清理后重试:

npm cache clean --force
rm -rf node_modules package-lock.json
npm install
npm start

3. 考虑迁移到Material UI v5的新包名

如果你是新项目或者有迁移的空间,官方在v5已经把包名从@material-ui改成了@mui,新的包结构更清晰,也能避免这类历史版本兼容问题:

npm uninstall @material-ui/core @material-ui/system
npm install @mui/material @mui/system @emotion/react @emotion/styled

之后记得把代码里的导入路径从@material-ui/xxx改成@mui/xxx。

内容的提问来源于stack exchange,提问作者pt2t

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.28 18:52:33