MUI v5用createTheme配置defaultProps失效、无components属性报错如何解决

• 核心原因是Material UI版本不匹配：components是MUI v5正式版才新增的配置项，如果你使用的是v4版本，或者v5的早期beta测试版，ThemeOptions类型里不存在该字段，就会抛出该报错。
• 若确认已安装v5正式版仍报错，大概率是TypeScript类型定义版本和核心库版本不一致，导致类型校验不通过。

方案1：升级到MUI v5正式版（推荐） #

先卸载旧版本依赖：

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

安装v5正式版依赖：

npm install @mui/material @emotion/react @emotion/styled

升级完成后即可正常使用components配置项。

方案2：兼容旧版本配置写法 #

如果暂时无法升级，可使用对应版本的配置语法：
v4版本、v5早期beta版配置默认属性用props字段，覆盖样式用overrides字段，示例如下：

const theme = createTheme({
  props: {
    MuiButtonBase: {
      disableRipple: true,
    },
  },
  overrides: {
    MuiButtonBase: {
      // 自定义样式配置写在这里
    }
  }
});

方案3：类型问题兜底处理 #

如果确认版本为v5正式版仅TypeScript类型报错，可先校验所有@mui开头的依赖包版本保持一致，仍报错的话可以用类型断言绕过校验：

import { createTheme, ThemeOptions } from '@mui/material/styles';

const theme = createTheme({
  components: {
    MuiButtonBase: {
      defaultProps: {
        disableRipple: true,
      },
    },
  },
} as ThemeOptions);

内容的提问来源于stack exchange，提问作者Sara Heijkenskjöld