非 React 项目用 AI SDK 报 TS2503 "Cannot find namespace 'JSX'" 怎么解决
【免费下载链接】aiThe AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents项目地址: https://gitcode.com/GitHub_Trending/ai/ai
在不含 React 的项目（例如官方文档举例的 Hono 服务器）里使用 AI SDK 时，TypeScript 编译可能报出error TS2503: Cannot find namespace 'JSX'.。这个错误的原因是项目中缺少@types/react类型包，安装它即可解决。
为什么非 React 项目会报这个错
官方排错文档（TypeScript error "Cannot find namespace 'JSX'"）给出了背景说明：AI SDK 存在一个对@types/react的依赖，而JSX命名空间正是由该包定义的。项目里缺少这个包时，TypeScript 就找不到JSX命名空间，从而报出 TS2503。
文档同时说明：这个对@types/react的依赖会在 AI SDK 的下一个主要版本中移除。也就是说，当前报错是版本过渡期内的现象，按下面的方式装上类型包就能消除错误。
解决方法：安装 @types/react
在报错项目的根目录执行：
npm install @types/react文档给出的就是这一条命令，把@types/react作为依赖安装后，JSX命名空间就有了定义来源。
如何确认已修复
重新运行之前报 TS2503 的 TypeScript 检查，确认该错误不再出现即可。以仓库中的 Hono 示例为例，它的 package.json 中定义了对应的类型检查脚本：
pnpm type-check该脚本实际执行的是tsc --build，运行后不再出现error TS2503: Cannot find namespace 'JSX'.即表示问题已解决。
适用范围
- 本方案适用于非 React 项目中使用 AI SDK 的场景，官方文档给出的示例就是 Hono 服务器（对应仓库中的 examples/hono 示例工程）。
- 如果之后升级到 AI SDK 的下一个主要版本，文档说明对
@types/react的依赖会被移除，届时不再需要为这个命名空间问题单独安装该包。
更多 TypeScript 相关的排错内容可参考 09-troubleshooting 目录 下的其他文档。
【免费下载链接】aiThe AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents项目地址: https://gitcode.com/GitHub_Trending/ai/ai
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
