react-doctor

React Doctor 是一款专为 React 开发者设计的专业诊断工具，旨在提升代码库的健康度。通过对项目根目录进行扫描，它能识别出在标准代码审查中可能被忽略的严重漏洞、架构反模式及性能瓶颈。该工具评估涵盖安全性、状态管理、打包体积与无障碍性（Accessibility）等超过 47 项规则，并提供 0 到 100 分的量化评分，协助团队追踪长期改进成效。

此工具专为负责维护可扩展且可靠 React 应用程序的前端工程师、资深开发人员及技术主管所设计。它特别适用于重构阶段、安全性审计，或是处理旧有代码库中的技术债。将 React Doctor 整合进您的开发工作流程，能协助您从被动的错误修复转向主动的质量保证。

• 执行 React 项目的静态分析，侦测常见错误，例如硬编码密钥、不安全的 eval() 使用方式以及无效的 useEffect Hook。

• 审查项目架构，找出结构性问题，如过大的组件、嵌套组件定义及不当的渲染模式。

• 评估性能指标，包含排版属性动画、转场瓶颈以及过大的模糊值。

• 分析打包体积（Bundle Size），标记 barrel 导入、过重的库（如 lodash 或 moment.js）以及未妥善实现的代码分割机会。

• 提供针对 Next.js 的专属反馈，例如缺失的 metadata、错误的客户端数据获取方式及异步组件错误。

• 检查无障碍属性（Accessibility），验证是否缺失 prefers-reduced-motion 等设置。

• 清除死码（Dead Code），包含未使用的文件、导出项目及类型，减少项目冗余。

• 工具可通过指令 npx -y react-doctor@latest . --verbose 在项目根目录下执行。

• 诊断结果提供明确的文件路径与行号，让您能立即进行修正。

• 建议工作流程：执行工具、优先处理高严重性错误、修复问题并重新扫描以确认分数提升。

• 评分系统：75-100 分为优，50-74 分需改进，0-49 分为危急状态。

• 在依据这些诊断进行自动或手动修复前，请确保您的 Git 状态为干净的。