Next.js教程中导入useActionState报错的原因及解决办法

问题场景 #

在学习Next.js Dashboard App教程的「提升可访问性」章节时，按要求在/app/ui/invoices/create-form.tsx文件中引入useActionState：

import { useActionState } from 'react';

触发TypeScript错误：

Module "react" has no exported member 'useActionState'.ts(2305)

当时使用的依赖版本：

• Next.js v15.0.0-canary.28
• React v19.0.0-rc-6230622a1a-20240610
• @types/react v18.2.21

问题原因 #

尽管React的预览版本已经内置了useActionState API，但配套的@types/react类型定义版本（v18.2.21）未同步更新，类型文件中缺少该API的声明，导致TypeScript无法识别。

解决方案 #

执行命令升级@types/react到包含useActionState类型声明的版本：

npm i @types/react@18.3.3

升级完成后，错误即可消除。

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