tailing-build-output

ビルド出力を追跡する

ターミナルのファイルを介してビルドプロセスをリアルタイムで監視し、問題が発生したら修正します。

ワークフロー

1. ビルドを開始する、または実行中のビルドを見つける

自分でビルドを開始するか、実行中のターミナルを見つけます。

head -n 10 <terminals_folder>/*.txt

npm run build、pnpm build、turbo build、docker build、tsc、vite buildなどのコマンドを探します。

2. 出力を定期的に確認する

ターミナルのファイルを定期的に読み込み、以下を確認します。

エラー（すぐに修正）：

• ERROR／Error:／error TS
• Module not found／Cannot find module
• SyntaxError／TypeError
• Failed to compile

警告（概要用に記録）：

• WARNING／Warning:／warn
• Deprecation／deprecated
• 未使用のインポート／変数
• バンドルサイズが大きい場合の警告（asset size limit）

進行状況の表示：

• Webpack：[XX%]、modules、chunks
• Turbo：タスク完了ログ
• Docker：Step X/Y
• TypeScript：ファイル数

3. ビルド中にエラーを修正する

エラーが発生したら、次の手順に従います。

1. エラーからファイルパスと行番号を抽出します
2. ソースファイルを読み込み、修正します
3. ビルドがウォッチモードに対応している場合は、自動的に再実行されます
4. 対応していない場合は、修正内容を記録してビルドを続行します。ほかのエラーが見つかることがあります

4. 概要レポート

ビルドが完了したら、ターミナルの末尾にあるexit_codeを確認します。

Build Summary:
  Status: Failed (exit code 1) / Succeeded
  Duration: ~45s
  Errors fixed: 3
  Remaining warnings: 2
    - Large bundle: src/pages/Dashboard.tsx (450kb)
    - Deprecated API: useRouter from 'next/router'

ヒント

• ビルド中は警告を修正せず、記録して後で対処します
• turbo buildでは、並列タスクの出力にエラーが表示されることがあるため、すべてのタスクログを確認します
• Dockerのビルドではレイヤーがキャッシュされます。Dockerfileの早い段階にあるファイルを修正すると、それ以降のレイヤーが再実行されます
• TypeScriptの--noEmitを使うと、ビルド全体を実行せずに型チェックできます