React代码健康度“体检医生”：专治AI写出来的烂React代码

你是否遇到过这样的场景：用Copilot、Cursor或自研AI编码助手生成的React组件，表面能跑，但暗藏性能陷阱、状态混乱、内存泄漏甚至安全漏洞？React Doctor 就是为此而生——它不是普通Linter，而是一位懂React底层原理的“代码医生”，专为识别AI生成代码中高频出现的反模式而设计。只需一条命令，就能给整个项目打分（0–100），并精准定位问题根源，告诉你“哪里病了、为什么病、怎么治”。

核心功能

• 一键全盘扫描：支持 Next.js、Vite、React Native 等主流React生态项目，自动识别框架特性与React版本，动态启用/禁用对应检查规则
• 量化健康评分：输出直观的0–100分“React健康度”，75+为优秀，50–74需优化，低于50则亮红灯预警，让技术债可视化
• 六大维度诊断：覆盖状态与副作用（useEffect滥用、闭包陷阱）、性能（重复渲染、不必要的memo）、架构（组件职责过载、props钻透）、安全（XSS风险、危险HTML插入）、无障碍（缺失aria标签、键盘导航缺陷）、死代码（未使用的hook、废弃导出）
• AI协同增强：运行 npx react-doctor install 可将检查规则注入本地AI编码代理（如GitHub Copilot、Tabnine等），从源头约束AI输出质量，真正实现“边写边治”
• 零配置开箱即用：无需修改eslint配置、不依赖特定构建工具，不改动任何源码，纯CLI驱动，3秒完成首次扫描
• 轻量可集成：MIT协议开源，支持CI/CD流水线集成（如GitHub Actions），可作为PR合并前的自动化守门员

适合哪些人用

前端工程师、技术负责人、AI工程化团队和开源维护者——尤其推荐给三类人：正在大规模采用AI编程助手的团队（避免“越写越脆”）；接手他人AI生成项目的维护者（快速建立代码信任感）；以及React教学与规范制定者（将最佳实践转化为可执行的检测标准）。它不取代Code Review，而是让每一次Review更聚焦、更高效。

快速上手

在你的React项目根目录终端中执行：

npx -y react-doctor@latest .

等待几秒，即可看到带颜色标识的健康报告（绿色=良好，黄色=警告，红色=严重）。若想让AI助手“学会规矩”，再运行：

npx -y react-doctor@latest install

按提示选择已安装的AI工具，React Doctor会自动为其注入React最佳实践知识库。所有操作均不修改项目文件，无残留、无侵入。

项目信息

TypeScript | ⭐ 7880 Stars | MIT 开源协议 | GitHub 项目地址

如果你正被AI生成的“看似正确实则危险”的React代码困扰，React Doctor就是那个帮你守住底线、重建质量信心的沉默守卫者。