如何在Next.js中正确运行Codemod？解决「Invalid transform choice」报错问题

你遇到的错误核心原因很明确：没有指定具体要执行的Codemod转换类型——Next.js的Codemod工具需要明确你想用它完成哪种代码转换操作，而不是仅传入目标目录pages。

正确的命令格式 #

你需要在命令中追加错误提示里列出的转换选项之一，完整命令结构如下：

npx @next/codemod [转换类型] pages

可用转换类型及用途拆解 #

这里帮你梳理每个选项的实际作用，方便你匹配自身需求：

• name-default-component: 自动为pages目录下的默认导出组件添加明确的组件名称（比如把匿名函数组件改成具名组件），能让React DevTools更清晰地展示组件层级结构。
• withamp-to-config: 将旧版Next.js中使用withAmp高阶组件的写法，转换为Next.js 9+推荐的页面amp配置方案（在getStaticProps/getServerSideProps中配置）。
• url-to-withrouter: 把直接调用next/router中url对象的代码，转换为使用withRouter高阶组件注入的router对象（适配旧版Next.js的路由使用规范）。

示例命令 #

比如你想给pages下的所有组件补充具名导出，就执行：

npx @next/codemod name-default-component pages

额外注意事项 #

• 运行前建议先提交Git代码（或手动备份项目），这样如果转换结果不符合预期，可以快速回退到原始状态。
• 确保你是在项目根目录下执行命令（从你的目录结构来看，pages在根目录下，当前执行位置是对的）。
• 如果遇到依赖相关的异常，可以尝试删除node_modules和package-lock.json，重新执行npm install后再运行Codemod命令。

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