MUI v5是否还支持使用makeStyles？迁移后渲染报错如何解决？

官方迁移文档说明：makeStyles JSS工具不再从@mui/material/styles中导出，可改用@mui/styles/makeStyles

以下是按要求修改后仍报错的排查方案：

• 确认@mui/styles为已安装依赖。该包是MUI v5的独立可选依赖，不会随@mui/material默认安装，执行对应安装命令：

  # npm 环境
  npm install @mui/styles
  # yarn 环境
  yarn add @mui/styles
  

• 全量校验项目中所有makeStyles的导入语句，确保路径完全匹配，无拼写、大小写错误，也没有残留的旧路径导入：

  // 正确导入写法
  import { makeStyles } from '@mui/styles';
  // 错误写法示例（需完全删除）
  // import { makeStyles } from '@mui/material/styles';
  

• TypeScript项目需额外安装对应类型声明包：

  # npm 环境
  npm install @types/mui__styles --save-dev
  # yarn 环境
  yarn add @types/mui__styles --dev
  

• 清理项目缓存后重启开发服务，避免缓存导致的导入识别错误：

  # 通用缓存清理操作，可根据你使用的构建工具调整
  rm -rf node_modules/.cache
  rm -rf dist build
  # 重启本地开发服务即可
  

如果仍无法解决，建议优先改用MUI v5官方主推的styled API或sx属性替代makeStyles，@mui/styles属于遗留JSS方案，本身不支持React 18并发渲染特性，长期使用可能存在兼容性隐患。

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