React Doctor

产品简介

React Doctor 是一款面向 React 代码库的“体检”工具，由 Million Software 团队开源维护。它对项目做确定性扫描，覆盖正确性、性能、安全、可访问性与可维护性五类问题，最终输出 0-100 的健康评分与可直接执行的修复建议。仓库托管在 GitHub 的 millionco/react-doctor，约 1.5 万 Star，官网提供完整的产品、配置与 API 文档，命令行一条 npx react-doctor@latest 即可在项目根目录跑起来。

核心功能

• 五大诊断类别：正确性、性能、安全、无障碍、可维护性，可用 --category 按类别单独查看；
• 默认扫描内置精选 lint 规则、React 复杂度与 JSX 重复度分析，以及依赖供应链检查；
• 0-100 健康评分：--score 只输出数字，--json 输出结构化报告，便于脚本与看板消费；
• 增量扫描：--scope changed 只报告相对基线新引入的问题，--base 指定比较基线，--verbose 给出文件与行号；
• CI 集成：GitHub Actions 提供预警式 PR 扫描（Action 已迭代到 v2），同时支持 GitLab、CircleCI、Jenkins、Buildkite；
• 编码智能体集成：可安装 React Doctor skill 与本地 hooks，附带面向 Cursor、Claude Code、Codex 的智能体手册；
• 规则可扩展：以 ESLint、oxlint 插件形式复用规则，并支持加载团队自定义检测器；
• 提供 Node.js API，可在脚本与服务中直接调用扫描能力。

特色优势

扫描结果是确定性的，不依赖模型猜测，同一份代码每次结论一致，适合当质量门禁使用；所有提示词以 markdown 形式托管，改一处源文件，GitHub Actions、编码智能体与 CLI 下次拉取即同步更新；产品定位直指 AI 生成代码——“你的智能体写出的烂 React，由它来抓”；扫描在本地完成，无需把代码上传到云端。

应用场景

• AI 批量生成 React 代码后的入库前体检；
• PR 阶段自动评论问题清单，作为合入前的质量把关；
• 团队落地编码规范，量化复杂度与重复 JSX 的治理进展；
• 依赖供应链风险检查，尽早发现可疑包行为；
• 大版本升级或大规模重构之后的回归对比。

适用人群

使用 React、Next.js、Vite 的前端工程师；用 Cursor、Claude Code、Codex 等编码智能体高频产出代码的开发者；需要在 CI 中建立质量门禁的技术团队；负责存量项目可维护性治理的架构师与技术负责人。

出品方

Million Software, Inc.，即开源项目 Million 背后的团队，仓库地址 github.com/millionco/react-doctor。许可证为修改版 MIT：个人与多数用途免费，AI 训练与大规模商业使用需向 Million Software, Inc. 申请书面授权。

更新动态

官方维护独立的 Changelog 页面，持续发布 CLI 版本更新；GitHub Action 从 v1 升级到 v2 并提供迁移文档；文档站同步提供产品概览、快速上手、CI 配置、规则配置、CLI 参考等 markdown 版手册，方便智能体与开发者直接读取；官网另设 Prompts 区，提供逐条规则的验证与修复提示词。

官网链接

https://react.doctor