RubyMine 2026.1 Help

Vite

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

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

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

始める前に

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

  2. JavaScript and TypeScript および Vite の必須プラグインが 設定 | プラグイン ページ、タブ インストール済み で有効化されていることを確認してください。 詳細は、 プラグインの管理を参照してください。

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

新しい Vite アプリケーションを開始する推奨方法は、RubyMine が npx を使ってダウンロードし実行する create-vite パッケージです。 その結果、開発環境には Vite を利用するよう事前構成が施され、 ReactVue.jsSvelte などの人気フレームワーク向けの基本テンプレートが用意されます。

もちろん、自分で create-vite をダウンロードするか、空の RubyMine プロジェクトを作成して Vite をインストールすることもできます。

create-vite で Vite アプリケーションを生成する

  1. ウェルカム 画面で 新規プロジェクト をクリックするか、メインメニューから ファイル | 新規 | プロジェクト を選択します。 新規 プロジェクト ダイアログが開きます。

  2. 左側のペインで、 Vite を選択します。

  3. 右側のペインで:

    1. プロジェクト関連ファイルが保存されるフォルダーへのパスを指定します。

    2. ノードランタイム フィールドで使用する Node.js ランタイムを指定します。 リストから設定済みのランタイムを選択するか、 追加 を選択して新しいランタイムを設定してください。

    3. Vite リストから npx create-vite を選択してください。

      または、npm バージョン 5.1 以前の場合、 ターミナル Alt+F12npm install --g create-vite を実行して、 create-vite パッケージを自分でインストールします。 アプリケーションを作成するときに、 create-vite パッケージが保存されているフォルダーを選択します。

    4. テンプレート リストから、アプリケーションで使用する予定のフレームワークを対象とする、 コミュニティが管理する Vite テンプレート(英語)を選択します。

    5. オプション:

      JavaScript の代わりに TypeScript を使用するには、 TypeScript テンプレートを使用 チェックボックスを選択します。 RubyMine はアプリケーション用の .ts ファイルと tsconfig.json 構成ファイルを生成する。

  4. 作成 をクリックすると、RubyMine は必要な構成ファイルをすべて含む Vite 専用プロジェクトを生成し、必要な依存関係をダウンロードします。 RubyMine は、アプリケーションを実行するためのデフォルト設定を持つ npm dev 構成も作成します。

空の RubyMine プロジェクトに Vite をインストールする

この場合、ビルドパイプラインを自分で構成する必要があります。 Vite オフィシャル Web サイト(英語)からプロジェクトに Vite を追加する方法については、こちらを参照してください。

空の RubyMine プロジェクトを作成する

  1. ウェルカム 画面で 新規プロジェクト をクリックするか、メインメニューから ファイル | 新規 | プロジェクト を選択します。 新規 プロジェクト ダイアログが開きます。

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

空のプロジェクトに Vite をインストールする

  1. Vite を利用する空の プロジェクト を開きます。

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

    npm install --save-dev vite

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

既存の Vite アプリケーションの開発を続けるには、RubyMine で開き、必要な依存関係をダウンロードしてください。

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

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

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

  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' を選択します。

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

RubyMine の外部で作成され、インポートされたプロジェクトを開くと、RubyMine はこのプロジェクトの馴染みのないソースコードの処理方法を決定できるダイアログを表示します。

次のいずれかのオプションを選択してください:

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

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

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

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

詳細は プロジェクトのセキュリティ をご覧ください。

RubyMine で Vite を構成する

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

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

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

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

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

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

    Completing alias in import statements

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

Vite 構成ファイルの分析に基づいて、RubyMine は Vite 構成を理解し、モジュールを解決し、JavaScript および TypeScript ファイルのコーディング支援を行います。

RubyMine では、自動と手動の構成モードのいずれかを選択できます。

自動構成では、RubyMine が各 JavaScript または TypeScript ファイルに関連する Vite 構成ファイルを自動検出します。

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

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

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

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

    • 自動: このモードでは、JavaScript または TypeScript ファイルについて、RubyMine はまずそのファイルがあるフォルダーで Vite 構成ファイルを探し、続いて親フォルダーなどを順に検索します。

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

      RubyMine は、次の名前および順序で JavaScript または TypeScript の Vite 構成ファイルを認識します:

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

      • vite.config.mjs

      • vite.config.cjs

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

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

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

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

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

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

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

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

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

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

create-vite を RubyMine 新規プロジェクト ウィザード 上記のようにで作成したアプリケーションの場合、RubyMine はデフォルト名 npm devnpm 構成を生成する。 この構成は、開発サーバーを起動し、開発モードでアプリケーションを起動する vite コマンドを実行します。

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

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

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

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

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

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

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

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

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

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

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

アプリケーションの実行

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

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

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

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

    または、 上記のように、RubyMine で起動時にアプリケーションを開くように有効化できます。

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

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

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

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

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

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

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

または、 JavaScript デバッグ実行/デバッグ構成でデバッグを開始に記載の通り、 すでに npmJavaScript デバッグ の実行/デバッグ構成を個別に作成し起動します。

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

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

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

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

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

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

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

    npm 設定、ブラウザータブ
  5. 実行 をクリックしてください。

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

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

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

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

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

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

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

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

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

    JavaScript デバッグ構成を作成する: URL を指定する
  5. Debug をクリックしてください。

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

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

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

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

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

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

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

    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": "vite --host=127.0.0.1"
  • あるいは、 dns.setDefaultResultOrder('ipv4first') vite.config.ts に追加します。

2026 年 6 月 2 日