diagnosing-react-code

诊断 React 代码

react-doctor 会扫描 React 软件包，并输出 0–100 的评分，以及有关安全性、性能、正确性和架构的诊断信息。它需要 Node ^20.19.0 || >=22.13.0。

首次运行前

• 会话中的首次运行会从 npm 下载并执行第三方软件包。运行前请征求用户同意，并告知固定的版本号。
• 默认情况下，评分来自 react-doctor 评分 API，供应链扫描会查询 Socket.dev；如果用户不希望有任何数据离开本机，请添加 --no-score --no-supply-chain（运行时将不提供评分）。

运行

在 package.json 的 dependencies 或 peerDependencies 中列有 react 的软件包目录内运行；如果在 monorepo 根目录运行，该工具会提示选择项目。

npx -y [email protected] --verbose --scope changed

• 固定版本号有助于比较不同运行的评分。切勿回退到 @latest；只有在有意修改固定版本号时才升级。如果某个标志不受支持，请检查 npx -y [email protected] --help 并作相应调整。
• --verbose 会列出所有规则和文件；默认只显示排名前 3 项。
• --scope changed 只报告与自动检测的基准 ref 相比，在已更改文件中的新增问题（使用 --base <ref> 设置基准）。使用 --scope full 检查整个软件包的健康状况。它取代了已弃用的 --diff。

修复循环

1. 记录基准评分，以及错误和警告数量。
2. 优先修复错误诊断、安全性和正确性问题。仅修复当前任务更改过的代码中的警告。
3. 使用相同命令重新运行，直到不再报告错误，且评分至少达到基准值。如果连续三轮修复后仍有错误，或修复会改变任务范围之外的行为，请停止并报告剩余问题。

报告版本和范围、从基准到最终的评分（或“未计算：--no-score”）、每项已修复的诊断，以及每项未修复的问题及其原因，格式为 <severity> <rule> <file>:<line>。