运行@mui/x-codemod v6.0.0/preset-safe时出现Identifier类型匹配错误

架构老林

2026-7-25

MUI-X v5 迁移至 v6 时 Codemod 报错处理

问题描述

执行MUI-X迁移命令 npx @mui/x-codemod v6.0.0/preset-safe . 时，27个文件触发错误：

Error: undefined does not match field "name": string of type Identifier

报错堆栈指向codemod内部逻辑，已将package.json中@mui/x-date-pickers版本设为6.0.0，但报错未明确关联代码问题。其中一个报错文件代码示例：

import React from 'react'
import { Table } from '@devexpress/dx-react-grid-material-ui'
import { DateTime } from 'luxon'

const DeliveryTimeCell = ({ value, ...props }) => {
  const formattedDate = DateTime.fromISO(value, { zone: 'utc' }).toLocaleString(
    DateTime.DATETIME_MED_WITH_SECONDS
  )

  return (
    <Table.Cell title={formattedDate} {...props}>
      {formattedDate}
    </Table.Cell>
  )
}

export default DeliveryTimeCell

解决方法

排除无关文件：报错文件未使用任何MUI-X组件，codemod可能误扫描了非目标文件。执行命令时通过--ignore-pattern排除无关文件，示例：
```
npx @mui/x-codemod v6.0.0/preset-safe . --ignore-pattern "**/devexpress/**" --ignore-pattern "**/luxon/**"
```
也可直接指定仅处理包含@mui/x-导入的文件。
升级codemod版本：v6.0.0的codemod可能存在bug，尝试使用最新版本的工具：
```
npx @mui/x-codemod latest/preset-safe .
```
手动隔离处理：暂时将报错文件移至临时目录，完成其他文件的codemod迁移后，检查这些文件是否存在MUI-X相关代码，无相关代码则直接移回，有则手动完成迁移。