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 狀態為乾淨的。