millionco/react-doctor

这是什么？

核心功能

• 01检查状态与副作用、性能、架构、安全、无障碍和可维护性问题。
• 02支持 Next.js、Vite、Astro、TanStack、React Native 和 Expo 项目。
• 03可为 Claude Code、Cursor、Codex、OpenCode 等编码智能体安装技能。
• 04可在 CI 中运行，只报告每个 Pull Request 引入的问题。
• 05通过 doctor.config.ts 配置检查规则。
• 06可对运行中的应用录制 Chrome DevTools 性能追踪。

适用场景

• 在合并前发现 React 代码中的性能和状态问题。
• 让编码智能体检查并修复自己生成的 React 代码。
• 在 CI 中拦截 Pull Request，尽早发现新增的 React 问题。
• 通过性能追踪分析本地运行的 React 应用。

快速上手

1. 1

   在项目根目录运行扫描

   npx react-doctor@latest
2. 2

   为你的编程代理安装该技能

   npx react-doctor@latest install

使用前须知

• !CLI 默认会收集崩溃报告和匿名使用数据，需要通过参数手动关闭。
• !仓库元数据中的许可证显示为 NOASSERTION，但 README 写明为 MIT，使用前请先核对许可证文件。

标签

常见问题

react-doctor 是什么？

一款扫描 React 代码的命令行工具与智能体技能，检查状态、性能、安全、无障碍和可维护性问题。 React Doctor 是一款命令行工具，对 React 代码执行确定性检查，报告状态与副作用、性能、架构、安全、无障碍和可维护性方面的问题。它支持基于 Next.js、Vite、Astro、TanStack、React Native 和 Expo 构建的项目，在项目根目录用 npx 即可运行。

react-doctor 可以免费使用吗？用的什么许可证？

react-doctor 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

react-doctor 还在维护吗？

活跃维护中。react-doctor 最近一次提交是在 2026年10月19日。

react-doctor 适合用来做什么？

在合并前发现 React 代码中的性能和状态问题。 让编码智能体检查并修复自己生成的 React 代码。 在 CI 中拦截 Pull Request，尽早发现新增的 React 问题。 通过性能追踪分析本地运行的 React 应用。

react-doctor 怎么安装和运行？

在项目根目录运行扫描: npx react-doctor@latest 为你的编程代理安装该技能: npx react-doctor@latest install

在哪里获取 react-doctor？

源代码和安装说明在 GitHub 上：https://github.com/millionco/react-doctor