JetBrains Rider 2026.1 Help

Vite

JetBrains Rider は、フロントエンド開発の体験を向上させる Vite ビルドツールと統合します。 Vite は、開発サーバーとビルドコマンドで構成されています。 ビルドサーバーは、ソースファイルをネイティブ ES モジュール経由で提供します。 ビルドコマンドは、Rollup でコードをバンドルし、本番用に高度に最適化された静的アセットを出力するよう事前構成済みです。

JetBrains Rider は、Vue style タグ内で tsconfig.json および jsconfig.json パスマッピングをサポートし、 Vite エイリアスも認識します。

異なる Vite 構成を持つ複数のモジュールで構成されるプロジェクトでは、JetBrains Rider は各モジュールに関連する構成ファイルを自動的に検出し、そこからモジュール解決ルールを使用できます。以下の 使用する Vite 構成ファイルの指定を参照してください。

始める前に

  1. Node.js をダウンロードしてインストールします。

  2. 設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript and TypeScript と入力します。 プラグインの詳細については、 プラグイン管理を参照してください。

  3. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 設定 | プラグイン ページの Marketplace タブに Vite プラグインをインストールして有効にします。

新しい Vite アプリケーションを作成する

既存または空のソリューションに Vite をインストールする

Vite オフィシャル Web サイト(英語)からプロジェクトに Vite を追加する方法について詳しくは、こちらを参照してください。

空の JetBrains Rider ソリューションを作成する

  1. ようこそ 画面で 新規ソリューション をクリックするか、メインメニューから ファイル | 新規 ソリューション を選択します。 新規 ソリューション ダイアログが開きます。

  2. 左側のペインで、 空の ソリューション を選択します。 右側のウィンドウで、アプリケーションフォルダーを指定し、 作成 をクリックします。

空のソリューションに Vite をインストールする

  1. Vite を使用する空の ソリューション を開きます。

  2. 組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install --save-dev vite

既存の Vite アプリケーションから始める

既存の Vite アプリケーションの開発を継続するには、JetBrains Rider で開き、必要な依存関係をダウンロードします。

すでにマシン上にあるアプリケーションソースを開く

  • ようこそ 画面で オープン をクリックするか、メインメニューから ファイル | オープン | オープン を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。

バージョン管理からアプリケーションのソースをチェックアウト

  1. ようこそ 画面で リポジトリのクローン をクリックします。

    または、メインメニューから Git | クローン… または VCS | バージョン管理から取得 を選択します。

    メインメニューの Git の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例: Mercurial または Perforce

  2. 表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 プロジェクトをチェックアウトする(クローン) を参照してください。

依存関係をダウンロードする

  • ポップアップで 'npm install' の実行 または 'yarn install' の実行 をクリックします。

    アプリケーションを開いて依存関係をダウンロードする

    npmYarn 1 、または Yarn 2 を利用できます。詳細は npm および Yarn をご参照ください。

  • または、エディターの package.json のコンテキストメニュー、または エクスプローラー ツールウィンドウ (Alt+1) で 'npm install' の実行 または 'yarn install' の実行 を選択します。

プロジェクトのセキュリティ

JetBrains Rider 以外で作成され、そこにインポートされたプロジェクトを開くと、JetBrains Rider は見慣れないソースコードを含むこのプロジェクトをどう処理するか決めるダイアログを表示します。

次のいずれかのオプションを選択します:

  • セーフモードでプレビュー :この場合、JetBrains Rider はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。

    JetBrains Rider はエディター領域の上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックして、いつでもプロジェクトをロードできます。

  • プロジェクトを信頼 :この場合、JetBrains Rider はプロジェクトを開いてロードします。 これは、プロジェクトが初期化され、プロジェクトのプラグインが解決され、依存関係が追加され、すべての JetBrains Rider 機能が使用可能になることを意味します。

  • 開かない :この場合、JetBrains Rider はプロジェクトを開きません。

JetBrains Rider で Vite を構成する

Vite 構成ファイルを作成する

  • プロジェクトの構造に応じて 1 つまたは複数の構成ファイルを作成します。 エクスプローラー ツールウィンドウ(Alt+1 )で親フォルダーを選択し、コンテキストメニューから 新規 | JavaScript ファイル を選択します。

    Vite 構成ファイルを作成する

    受け入れ可能な名前は vite.config.js / vite.config.ts vite.config.mjs または vite.config.cjs です。

    Vite オフィシャル Web サイト(英語)の詳細を参照してください。

  • 必要に応じて、後で import ステートメントで認識される alias を使用します。 エイリアスの定義では必ず絶対パスを指定してください。 Vite オフィシャル Web サイト(英語)から詳細を参照してください。

    Completing alias in import statements

使用する Vite 構成ファイルを指定する

Vite 構成ファイルの分析に基づき、JetBrains Rider は Vite 構成を理解し、モジュールを解決し、JavaScript および TypeScript ファイルでコーディング支援を提供します。

JetBrains Rider では、自動または手動の構成モードを選択できます。

自動構成を使用すると、JetBrains Rider は各 JavaScript または TypeScript ファイルに関連する Vite 構成ファイルを自動検出します。

手動構成 を使用すると、プロジェクトで使用する Vite 構成ファイルを指定します。 Vite 構成ファイルの名前が JetBrains Rider で認識されない場合は、下記の 認識されている Vite 構成名のリストを参照してください。

Vite 構成を検出する方法を選択する

  1. 設定 ダイアログ(Ctrl+Alt+S )を開き、 言語 & フレームワーク | JavaScript | Vite に進みます。

  2. モジュール解決のための Vite 構成ファイルを検出 領域で、次のいずれかのオプションを選択します。

    • 自動: このモードでは、JavaScript または TypeScript ファイルの場合、JetBrains Rider はまずその JavaScript または TypeScript ファイルがあるフォルダーで Vite 構成ファイルを探し、次にその親フォルダーなどで順に探していきます。

      その結果、プロジェクトが異なる Vite 構成の複数のモジュールで構成されている場合、各モジュールは独自の Vite 構成ファイルのモジュール解決ルールを使用します(そのような構成が見つかった場合)。

      JetBrains Rider は、次の順序で以下の名前の JavaScript または TypeScript の Vite 構成ファイルを認識します:

      • vite.config.js / vite.config.ts

      • vite.config.mjs

      • vite.config.cjs

    • 手動:: 構成ファイル フィールドで、使用する Vite 構成の場所を指定します。

      このモードでは、指定された構成ファイルの解決ルールがプロジェクト内のすべてのモジュールに適用されます。

      Vite 構成ファイルの名前が JetBrains Rider で認識されない場合は、このオプションを選択します。上記の 認識される Vite 構成名のリストを参照してください。

      vite 構成ファイルを手動で選択する

Vite アプリケーションを実行する

  1. package.json dev スクリプトの横にあるガターで 実行アイコン をクリックするか、 ターミナル Alt+F12npm run dev コマンドを実行するか、 npm ツールウィンドウ (表示 | ツールウィンドウ | npm) で dev タスクをダブルクリックします。

    Run a Vite app in the development mode from package.json
  2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ちます。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションが create-vue で生成された場合、デフォルトの URL は http://localhost:5173/ です。 アプリケーションを表示するには、このリンクをクリックしてください。

    Vue.js アプリは開発モードで実行されています

実行 / デバッグ構成を介して Vite アプリケーションを実行する

create-vite で作成されたアプリケーションの場合、JetBrains Rider は npm 構成を生成します。 この構成は、開発サーバーを起動し、開発モードでアプリケーションを起動する vite コマンドを実行します。

それ以外の場合は、ホスト、ポートなどの実際の設定を手動で 実行 / デバッグ構成を作成するする必要があります。

npm 実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集 に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ

    開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから npm を選択します。

  2. 開いた 実行 / デバッグ構成: npm ダイアログの Configuration タブで、 package.json の場所、Node.js ランタイム、および使用するパッケージマネージャーを指定します。

    コマンド フィールドで、リストから run を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの dev スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 package.json で別のスクリプトを構成することもできます。

    npm 実行 / デバッグ構成
  3. オプション:

    ブラウザーでアプリケーションを開くには、構成を次のように更新します: ブラウザー / Live Edit タブで、 起動後 チェックボックスをオンにし、アプリケーションを開くブラウザーを選択して、アプリケーションが実行される URL アドレスを指定します。

    アプリケーションをデバッグする場合は、 Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択します。

    ブラウザー / ライブ編集タブ: ブラウザーを選択

アプリケーションの実行

  1. ツールバーのリストから npm dev run 構成を選択し、その横にある 実行 をクリックします。

    実行 / デバッグ構成を介して開発モードで Vite アプリを実行する
  2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ちます。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションを表示するには、このリンクをクリックしてください。

    Vite アプリの実行: 開発サーバーの準備ができました

    または、 上記のように、JetBrains Rider が起動時にアプリケーションを開く機能を有効化します。

Vite アプリケーションをデバッグする

デバッグセッションは、 実行 / デバッグ構成を起動するから開始することも、開発モードでアプリケーションが実行されている URL を表示する 実行ツールウィンドウから開始することもできます。

実行 / デバッグ構成を介してデバッグを開始する

Vite アプリケーションをデバッグするには、2 つの実行/デバッグ構成が必要です:

  • 上記のように、開発モードでアプリケーションを起動するための npm 構成。

  • 開発モードで実行されているアプリケーションにデバッガーを接続するための JavaScript デバッグ 構成。

npm 実行 / デバッグ構成を使用して Vite アプリケーションを実行およびデバッグするに従って、 npm 構成内に JavaScript デバッグ 構成を作成して、一度に起動することができます。

または、 npmJavaScript デバッグ の実行/デバッグ構成を、 JavaScript デバッグ用実行/デバッグ構成の開始の説明に従い、個別に作成して起動してください。

単一の npm 実行 / デバッグ構成で Vite アプリケーションを実行およびデバッグする

  1. コードに ブレークポイントを設定します。

  2. 上記の説明に従ってnpm 構成を作成します。

    create-vite でアプリケーションを生成した場合、JetBrains Rider は npm dev というデフォルト名の npm 構成をすでに作成しています。 この構成は、 実行 ウィジェットおよび 実行 / デバッグ構成 ダイアログから利用できます。

    自動生成された npm 実行 / デバッグ構成
  3. 開いた 実行 / デバッグ構成: npm ダイアログの Configuration タブで、 package.json の場所、Node.js ランタイム、および使用するパッケージマネージャーを指定します。

    コマンド フィールドで、リストから run を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの dev スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 package.json で別のスクリプトを構成することもできます。

    npm 実行 / デバッグ構成
  4. ブラウザー / Live Edit タブで、 起動後 チェックボックスを選択し、リストから Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択し、 JavaScriptデバッガーを使⽤ チェックボックスを選択して、アプリケーションを実行する URL を指定します。

    npm 設定、ブラウザータブ
  5. 実行 をクリックします。

    構成を再実行するには、 実行 ウィジェットのリストから構成を選択し、その横にある 実行 をクリックします。

    JetBrains Rider はアプリケーションを開発モードで実行し、同時にデバッグセッションを起動します。

    デバッグセッション
  6. 最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行し停止および再開し中断時に調査し 、コールスタックや変数を調べ、ウォッチを設定し、変数を評価し、 実際の HTML DOM を表示するなど、さまざまな操作が行えます。

JavaScript デバッグ実行 / デバッグ構成でデバッグを開始する

  1. コードに ブレークポイントを設定します。

  2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 この URL をコピーして、 後で JavaScript デバッグ構成で指定します

    アプリケーションは開発モードで実行されています
  3. JavaScript デバッグ 構成を作成します。 これを行うには、メインメニューの 実行 | 実行構成の編集 に移動し、 追加アイコン をクリックして、リストから JavaScript デバッグ を選択します。

  4. 開いた 実行 / デバッグ構成: JavaScript デバッグ ダイアログで、構成の名前と、開発モードでアプリケーションが実行されている URL アドレスを指定します。 この URL は 実行 ツールウィンドウまたは ターミナル上記の説明 の通りコピーできます。

    JavaScript デバッグ構成を作成する: URL を指定する
  5. デバッグ をクリックします。

    構成を再実行するには、 実行 ウィジェットのリストから構成を選択し、その横にある デバッグ をクリックします。

    実行ウィジェットから JavaScript デバッグ構成を実行する
  6. 最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行し停止および再開し中断時に調査し 、コールスタックや変数を調べ、ウォッチを設定し、変数を評価し、 実際の HTML DOM を表示するなど、さまざまな操作が行えます。

実行ツールウィンドウまたは組み込みのターミナルからデバッグを開始する

アプリケーションが localhost の開発モードで実行されている場合、特に create-vite で生成された場合は、 > 実行 ツールウィンドウまたは組み込みの ターミナル から直接デバッグセッションを開始できます。

  1. コードに ブレークポイントを設定します。

  2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

  3. 実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 Ctrl+Shift を押したまま、この URL リンクをクリックします。 JetBrains Rider は、自動生成された 構成(タイプ: JavaScript デバッグ )でデバッグセッションを開始します。

    Starting a debugging session from the Run tool window, the application is running on localhost

    新しいターミナルから開発モードでアプリケーションを起動した場合は、リンクの横の ブラウザーでデバッグを開始する ボタンをクリックするだけです。

    新しいターミナル: ブラウザーでデバッグを開始ボタン

最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行し停止および再開し中断時に調査し 、コールスタックや変数を調べ、ウォッチを設定し、変数を評価し、 実際の HTML DOM を表示するなど、さまざまな操作が行えます。

Node.js 17 以降のトラブルシューティング

Node.js バージョン 17 以降を使用している場合、デバッグセッション中にネットワーク接続の問題が発生し、デバッガーの接続やソースマップのロードに問題が発生することがあります。

回避策は、 --host 127.0.0.1 をサーバーに渡すことです。 これは、次のいずれかの方法で行うことができます。

  • package.json dev スクリプトを更新します。

    "dev": "vite --host=127.0.0.1"
  • あるいは、 dns.setDefaultResultOrder('ipv4first') vite.config.ts に追加します。

2026 年 6 月 12 日