Skip to content

feat(cli): support naming the CPU profile via --profile [name] #2811

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jay-es merged 1 commit into from
Aug 21, 2026
Merged

feat(cli): support naming the CPU profile via --profile [name] #2811

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions guide/cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ vite [root]
| `-l, --logLevel <level>` | info \| warn \| error \| silent （`string`） |
| `--clearScreen` | ログを表示する際に画面をクリアするかどうか（`boolean`） |
| `--configLoader <loader>` | `bundle`: Rolldown を使用して設定をバンドルする。`runner`（実験的機能）: その場で処理する。`native`（実験的機能）: ネイティブランタイムを使用して読み込む（デフォルト: `bundle`） |
| `--profile` | 組み込みの Node.js インスペクターを起動する（[パフォーマンスのボトルネック](/guide/troubleshooting#performance-bottlenecks)を確認してください） |
| `--profile [name]` | 組み込みの Node.js インスペクターを起動し、プロファイルを `<name>.cpuprofile` に書き込む（[パフォーマンスのボトルネック](/guide/troubleshooting#performance-bottlenecks)を確認してください）（`boolean \| string`） |
| `-d, --debug [feat]` | デバッグログを表示する（`string \| boolean`） |
| `-f, --filter <filter>` | デバッグログをフィルタリングする（`string`） |
| `-m, --mode <mode>` | env モードを設定する（`string`） |
Expand Down Expand Up @@ -67,7 +67,7 @@ vite build [root]
| `-l, --logLevel <level>` | info \| warn \| error \| silent （`string`） |
| `--clearScreen` | ログを表示する際に画面をクリアするかどうか（`boolean`） |
| `--configLoader <loader>` | `bundle` で Rolldown を使用して設定をバンドルするか、`runner`（実験的）でその場で処理するか、`native`（実験的）でネイティブランタイムを使用して読み込むか指定する（デフォルト: `bundle`） |
| `--profile` | 組み込みの Node.js インスペクターを起動する（[パフォーマンスのボトルネック](/guide/troubleshooting#performance-bottlenecks)を確認してください）|
| `--profile [name]` | 組み込みの Node.js インスペクターを起動し、プロファイルを `<name>.cpuprofile` に書き込む（[パフォーマンスのボトルネック](/guide/troubleshooting#performance-bottlenecks)を確認してください）（`boolean \| string`） |
| `-d, --debug [feat]` | デバッグログを表示する（`string \| boolean`） |
| `-f, --filter <filter>` | デバッグログをフィルタリングする（`string`） |
| `-m, --mode <mode>` | env モードを設定する（`string`） |
Expand Down
2 changes: 1 addition & 1 deletion guide/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -240,7 +240,7 @@ vite build --profile
アプリケーションをブラウザーで開いたら、読み込みが終わるのを待ち、ターミナルに戻って `p` キーを押し（Node.js インスペクターを停止します）、次に `q` キーを押して開発サーバーを停止します。
:::

Node.js インスペクターはルートフォルダーに `vite-profile-0.cpuprofile` を生成し、https://www.speedscope.app/ に遷移、`BROWSE` ボタンを使って CPU プロファイルをアップロードし、結果を検証します。
Node.js インスペクターはルートフォルダーに `vite-profile-0.cpuprofile` を生成します。代わりに `<name>.cpuprofile` を書き込むには `--profile <name>`（または `--profile=<name>`）を渡します。https://www.speedscope.app/ に遷移、`BROWSE` ボタンを使って CPU プロファイルをアップロードし、結果を検証します。

[vite-plugin-inspect](https://github.com/antfu/vite-plugin-inspect) をインストールすると、Vite プラグインの中間状態を検査でき、アプリケーションのボトルネックとなっているプラグインやミドルウェアを特定するのに役立ちます。このプラグインは開発モードとビルドモードの両方で使用できます。詳しくは readme ファイルをご覧ください。

Expand Down
Loading