Next.js 工具集 是做什麼的?
優先級:P2(中等)
結構
project/
├── .next/ # 建置產出物
├── next.config.js # 進階配置
└── .eslintrc.json # Next 外掛
實作指南
- 建置架構:使用
Turbopack(現代)或 Webpack(舊式)。啟用 --turbo 以獲得更快的增量開發體驗。
- 最小化:確保在
next.config.js 中設定 output: 'standalone',以實現最佳化的 Docker 部署。使用對應於 ProGuard / Uglify 的工具來縮減資產大小。
- Linting:在 CI/CD 管道中強制執行
next lint(Next.js ESLint 外掛)和 tsc(型別檢查)。
- 資產最佳化:使用
@next/bundle-analyzer 檢查大小。透過 next/image 最佳化圖片,並移除未使用的依賴。
- 遙測:若需要隱私,可透過
next telemetry disable 選擇關閉遙測。
- 環境:在 Next.js 中使用
.env 管理(僅伺服器端 vs NEXT_PUBLIC_*)。在執行時期使用 Zod 驗證架構。
- CI/CD:在 CI 中快取
.next/cache 資料夾,可將建置時間提升 50% 以上。
反模式
- 不要用
npm run start 開發:請使用 next dev(或 next dev --turbo)。
- 不要忽略未檢查的套件成長:在佈署前用
@next/bundle-analyzer 進行分析。
- 不要使用自訂 ESLint 規則取代外掛:使用
eslint-plugin-next 進行 Next.js 感知的 Linting。
- 不要在生產環境中使用
console.log:請使用結構化日誌器(Pino、Winston)。
參考資料