From 772b2141368169b3985061465938df77dfa546b4 Mon Sep 17 00:00:00 2001 From: Jun Shindo <46585162+jay-es@users.noreply.github.com> Date: Thu, 6 Feb 2025 20:28:51 +0900 Subject: [PATCH] feat: use native runtime to import the config --- config/index.md | 6 ++++-- guide/cli.md | 4 ++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/config/index.md b/config/index.md index 4d48ce9d..0a69e68b 100644 --- a/config/index.md +++ b/config/index.md @@ -22,8 +22,10 @@ export default { vite --config my-config.js ``` -::: tip 設定のビルド -デフォルトでは、Vite は `esbuild` を使用して設定を一時ファイルにバンドルします。これはモノレポ内の TypeScript をインポートする際に問題を引き起こすことがあります。このアプローチで問題が起きた場合は、`--configLoader=runner` を指定すると、代わりにモジュールランナーを利用できます。これにより、一時的な設定が作成されなくなり、すべてのファイルがその場で変換されるようになります。モジュールランナーは設定ファイル内では CJS をサポートしていませんが、外部の CJS パッケージは通常通りに機能するはずです。 +::: tip 設定の読み込み +デフォルトでは、Vite は `esbuild` を使用して設定を一時ファイルにバンドルし、読み込みます。これはモノレポ内で TypeScript をインポートする際に問題を引き起こす可能性があります。このアプローチで問題が起きた場合は、代わりに [module runner](/guide/api-environment-runtimes.html#modulerunner) を使用するように `--configLoader runner` を指定できます。これにより、一時的な設定が作成されなくなり、すべてのファイルがその場で変換されるようになります。モジュールランナーは設定ファイル内では CJS をサポートしていませんが、外部の CJS パッケージは通常通りに機能するはずです。 + +あるいは、TypeScript をサポートする環境（例：`node --experimental-strip-types`）を使用している場合、またはプレーンな JavaScript のみを記述している場合は、`--configLoader native` を指定して、環境のネイティブランタイムを使用して設定ファイルを読み込むことができます。設定ファイルによってインポートされたモジュールの更新は検出されないため、Vite サーバーは自動的に再起動されないことに注意してください。 ::: ## 設定の自動補完 diff --git a/guide/cli.md b/guide/cli.md index 0984329c..769ee6e3 100644 --- a/guide/cli.md +++ b/guide/cli.md @@ -15,7 +15,7 @@ vite [root] #### オプション | オプション | | -|---------------------------|-------------------------------------------------------------------------------------------------------| +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--host [host]` | ホスト名を指定する（`string`） | | `--port ` | ポートを指定する（`number`） | | `--open [path]` | 起動時にブラウザーを起動する（`boolean \| string`） | @@ -26,7 +26,7 @@ vite [root] | `--base ` | public のベースパス（デフォルト: `/`）（`string`） | | `-l, --logLevel ` | info \| warn \| error \| silent （`string`） | | `--clearScreen` | ログを表示する際に画面をクリアするかどうか（`boolean`） | -| `--configLoader ` | `bundle`: esbuild を使用して設定をバンドルする。`runner` (実験的機能): その場で処理する (デフォルト: `bundle`) | +| `--configLoader ` | `bundle`: esbuild を使用して設定をバンドルする。`runner`（実験的機能）: その場で処理する。`native`（実験的機能）: ネイティブランタイムを使用して読み込む（デフォルト: `bundle`） | | `--profile` | 組み込みの Node.js インスペクターを起動する（[パフォーマンスのボトルネック](/guide/troubleshooting#performance-bottlenecks)を確認してください） | | `-d, --debug [feat]` | デバッグログを表示する（`string \| boolean`） | | `-f, --filter ` | デバッグログをフィルタリングする（`string`） |