# Vite

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

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

CLion は、Vue  `style`  タグ内で  `tsconfig.json`  および  `jsconfig.json`  のパスマッピングをサポートし、 [Vite エイリアス](https://vitejs.dev/config/#resolve-alias)を認識します。

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

> **Note:**
> CLion を Vite と統合するには、  `vite`  パッケージをプロジェクトまたはグローバルにインストールする必要があります。 [create-vite でアプリケーションを作成する](#create_new_vite_app)または [vite パッケージを手動でインストールします](#install_vite_in_empty_project)。 [既存の Vite アプリを操作するに](#starting_with_existing_vite_application)は、  `npm install`  を実行する前に、  `パッケージ.json​​`  に Vite がリストされていることを確認してください。

## 始める前に

Procedure:

1. お使いのコンピューターに [Node.js(英語)](http://nodejs.org/) がインストールされていることを確認してください。

2. JavaScript と TypeScript  と  Vite  に必要なプラグインが   設定 | プラグイン   ページで有効化されていることを確認してください。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

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

新しい Vite アプリケーションの開始に推奨される方法は、CLion が [npx](https://www.npmjs.com/package/npx) を使ってダウンロード・実行する [create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite) パッケージです。 その結果、開発環境は Vite と、 [React](react.html)、 [Vue.js](null)、 [Svelte](null) などの人気フレームワークのいずれかに対応する基本テンプレートを使用するように事前構成されます。

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

> **Tip:**
> [Vite.js 公式サイト(英語)](https://vitejs.dev/guide/#scaffolding-your-first-vite-project)から Vite を開始する方法の詳細を参照してください。

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

Procedure:

1. ようこそ   画面で   新規プロジェクト   をクリックするか、メインメニューから  `ファイル | 新規 プロジェクト`  を選択します。 [新規 プロジェクト ダイアログ](null)が開きます。

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

3. 右側のペイン：

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

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

3.

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

または、npm バージョン 5.1 以前の場合、   ターミナルエミュレータ   `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)) で  `npm install --g create-vite`  を実行して、  `create-vite`  パッケージを自分でインストールします。 アプリケーションを作成するときに、  `create-vite`  パッケージが保存されているフォルダーを選択します。

4.    テンプレート   リストから、アプリケーションで使用する予定のフレームワークを対象とする、 [コミュニティが管理する Vite テンプレート(英語)](https://github.com/vitejs/awesome-vite#templates)を選択します。

5.

オプション:

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

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

> **Tip:**
> または、組み込みの   ターミナルエミュレータ   を開いて、次のように入力します。
>
>
>
> 1.   `npx create-vite <application-name>`  を使用してアプリケーションを作成します。
>
> 2.   `cd <application-name>`  を押してアプリケーションフォルダーに切り替えます。
>
> 3.   `npm start`  を実行して Node.js サーバーを起動します。

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

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

Procedure: 空の CLion プロジェクトを作成する

1. ようこそ   画面で   新規プロジェクト   をクリックするか、メインメニューから  `ファイル | 新規 プロジェクト`  を選択します。 [新規 プロジェクト ダイアログ](null)が開きます。

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

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

1. Vite  を使う空の プロジェクト を開きます。

2. コマンドライン シェルまたは組み込みの   ターミナルエミュレータ  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）で、次を入力します：

`npm install --save-dev vite`

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

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

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

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

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

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

あるいは、メインメニューから  `ファイル | 新規 | バージョン管理からプロジェクト…`  、  `Git | クローン…`  、  `VCS | バージョン管理から取得`  を選択します。

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

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

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

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

![アプリケーションを開いて依存関係をダウンロードする](https://resources.jetbrains.com/help/img/idea/2026.3/ws_npm_yarn_package_run_npm_install.png)

[npm](https://docs.npmjs.com/)、 [Yarn 1](https://classic.yarnpkg.com/lang/en/)、または [Yarn 2](https://yarnpkg.com/) を使用できます。詳細は [npm と Yarn](installing-and-removing-external-software-using-node-package-manager.html) をご確認ください。

* または、エディターの  `パッケージ.json​​`  のコンテキストメニュー、または   プロジェクト   ツールウィンドウ ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) ) で   'npm install' の実行   または   'yarn install' の実行   を選択します。

> **Note:**
> `パッケージ.json​​`  が  `dependencies`  または  `devDependencies`  に  `vite`  パッケージをリストしていることを確認してください。 これは、CLion の Vite との統合、特に構成ファイルの自動検出には  `vite`  パッケージをプロジェクトまたはグローバルにインストールしておく必要があるためです。

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

CLion の外部で作成され、そこにインポートされたプロジェクトを開くと、CLion は、未知のソースコードを含むこのプロジェクトの処理方法を選択できるダイアログを表示します。

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

* セーフモードでプレビュー : この場合、CLion はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。 CLion はエディター領域の上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックすることで、いつでもプロジェクトをロードできます。

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

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

詳細については、 [プロジェクトのセキュリティ](project-security.html) を参照してください。

> **Tip:**
> ようこそ画面や  `ファイル｜新規｜プロジェクト`  で作成されたプロジェクトは、自動的に信頼済みと見なされます。

## CLion で Vite を構成する

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

* プロジェクト構造に応じて、1 つまたは複数の構成ファイルを作成します。   プロジェクト   ツールウィンドウ ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) で親フォルダーを選択し、コンテキストメニューから  `新規 | JavaScript ファイル`  を選択します。

![Vite 構成ファイルを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vite_create_config.png)

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

[Vite オフィシャル Web サイト(英語)](https://vitejs.dev/config/)の詳細を参照してください。

* 必要に応じて、後で  `import`  ステートメントで認識される  `alias`  を使用します。 エイリアスの定義では必ず絶対パスを指定してください。 [Vite オフィシャル Web サイト(英語)](https://vitejs.dev/config/shared-options.html#resolve-alias)から詳細を参照してください。

![Completing alias in import statements](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vite_alias_completion.animated.gif)

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

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

CLion では、自動と手動、2 つの構成モードから選択できます。

[自動構成](#specify_vite_configuration_file_auto_detection_procedure) では、CLion が各 JavaScript または TypeScript ファイルに関連する Vite 構成ファイルを自動検出します。

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

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

1. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）を開き、  `言語 & フレームワーク | JavaScript | Vite`  に進みます。

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

* 自動： このモードでは、JavaScript または TypeScript ファイルについて、CLion はまずそのファイルがあるフォルダーで Vite 構成ファイルを探し、次に親フォルダーなどで探します。 その結果、プロジェクトが異なる Vite 構成を持つ複数のモジュールで構成されている場合、各モジュールは該当する Vite 構成ファイルのモジュール解決ルールを利用します（該当構成が見つかった場合）。 CLion は、次の名前と順序で JavaScript または TypeScript の Vite 構成ファイルを認識します： * `vite.config.js` / `vite.config.ts` * `vite.config.mjs` * `vite.config.cjs`

* 手動： : 構成ファイル フィールドで、使用する Vite 構成の場所を指定します。 このモードでは、指定された構成ファイルの解決ルールがプロジェクト内のすべてのモジュールに適用されます。 Vite 構成ファイルの名前が CLion で認識されない場合は、このオプションを選択します。上記の [認識される Vite 構成名のリスト](#specify_vite_configuration_recognized_names)を参照してください。 ![vite 構成ファイルを手動で選択する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vite_select_config.png)

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

Procedure:

1. `パッケージ.json​​`  の  `dev`  スクリプトの横にあるガターで ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリック、あるいは   ターミナルエミュレータ   `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)) で  `npm run dev`  コマンドを実行、または [npm ツールウィンドウ](npm-tool-window.html)（  `表示 | ツール Windows | npm` ）で  `dev`  タスクを double-click してください。

![Run a Vite app in the development mode from package.json](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vite_run_dev_mode_package_json.animated.gif)

2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまでお待ちください。

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

![Vue.js アプリは開発モードで実行されています](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vue_run_app_url.png)

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

[上記のように](#creating_vite_app_with_create_vite)、CLion   新規プロジェクト   ウィザードで  `create-vite`  を使って作成したアプリケーションには、CLion がデフォルト名   npm dev   の [npm](run-debug-configuration-npm.html) 構成を生成します。 この構成では、開発サーバーを起動し、アプリケーションを開発モードで開始する  `vite`  コマンドを実行します。

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

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

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

![構成の編集を開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/vite_run_config_create.png)

開いた   実行構成の編集   ダイアログで、ツールバーの   追加   ボタン ( ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)) をクリックし、リストから   npm   を選択します。

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

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

![npm 実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/vite_debug_npm_rc.png)

3. オプション:

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

アプリケーションをデバッグする場合は、 [Google Chrome(英語)](http://www.google.com/chrome/) または別の [Chromium ベースのブラウザー(英語)](https://www.chromium.org/)を選択します。

![ブラウザー / ライブ編集タブ: ブラウザーを選択](https://resources.jetbrains.com/help/img/idea/2026.3/vite_run_rc_browser_tab_select_browser.png)

Procedure: アプリケーションの実行

1. ツールバーのリストから   npm dev   run 構成を選択し、その横にある ![実行](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックします。

![実行 / デバッグ構成を介して開発モードで Vite アプリを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vite_run_dev_mode.png)

2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまでお待ちください。

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

![Vite アプリの実行: 開発サーバーの準備ができました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vite_run_dev_server_ready.png)

あるいは、 [上記](#ws_vite_start_app_in_dev_mode_enable_opening_browser)のように CLion で起動時にアプリケーションを開くよう有効化することもできます。

> **Note:**
> 開発サーバーが実行中は、ソースファイルを変更して更新を保存すると、アプリケーションは自動的に再読み込みされます。

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

> **Note:**
> Vite アプリケーションのデバッグは、 [Google Chrome(英語)](http://www.google.com/chrome/) およびその他の [Chromium ベースのブラウザー(英語)](https://www.chromium.org/)でのみサポートされています。

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

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

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

* [上記のよう](#vite_run)に、開発モードでアプリケーションを起動するための npm 構成。

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

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

または、 [JavaScript Debug 実行 / デバッグ構成でデバッグを開始する](#vite_debug_via_js_debug_rc)に記載のとおり、   npm   と   JavaScript デバッグ​   の実行 / デバッグ構成を別々に作成・起動してください。

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

1. コードに [ブレークポイントを設定](using-breakpoints.html)します。

2. [上記の説明に従って](#vite_running_and_debugging_run_via_rc_create_rc)   npm   構成を作成します。

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

![自動生成された npm 実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/vite_debug_autogenerated_npm_rc.png)

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

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

![npm 実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/vite_debug_npm_rc.png)

4. ブラウザー / Live Edit   タブで、   起動後   チェックボックスを選択し、リストから [Google Chrome(英語)](http://www.google.com/chrome/) または別の [Chromium ベースのブラウザー(英語)](https://www.chromium.org/)を選択し、   JavaScript デバッガーで   チェックボックスを選択して、アプリケーションを実行する URL を指定します。

![ブラウザー / ライブ編集タブ: ブラウザーを選択](https://resources.jetbrains.com/help/img/idea/2026.3/vite_run_rc_browser_tab_select_browser.png)

5. 実行   をクリックします。

構成を再実行するには、   実行   ウィジェットのリストから構成を選択し、その横にある ![実行](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックします。

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

![デバッグセッション](https://resources.jetbrains.com/help/img/idea/2026.3/vite_debug_npm_rc_debugging_session.png)

6. 最初のブレークポイントに到達したら、 [デバッグツールウィンドウ](debug-tool-window.html)に切り替え、通常どおり進めます。 [プログラムをステップ実行](stepping-through-the-program.html)、 [プログラムの実行を停止して再開](null)、 [中断時にそれを調べる](examining-suspended-program.html)、コールスタックと変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM の表示](viewing-actual-html-dom.html)などが可能です。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

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

1. コードに [ブレークポイントを設定](using-breakpoints.html)します。

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

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

![アプリケーションは開発モードで実行されています](https://resources.jetbrains.com/help/img/idea/2026.3/vite_debug_app_running_in_dev_mode.png)

3. JavaScript デバッグ​   構成を作成します。 これを行うには、メインメニューの  `実行 | 実行構成の編集​`  に移動し、 ![追加アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、リストから   JavaScript デバッグ   を選択します。

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

![JavaScript デバッグ構成を作成する: URL を指定する](https://resources.jetbrains.com/help/img/idea/2026.3/vite_debug_create_js_debug_rc.png)

5. デバッグ   をクリックします。

構成を再実行するには、   実行   ウィジェットのリストから構成を選択し、その横にある ![デバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

![実行ウィジェットから JavaScript デバッグ構成を実行する](https://resources.jetbrains.com/help/img/idea/2026.3/vite_debug_rerun_js_debug_rc.png)

6. 最初のブレークポイントに到達したら、 [デバッグツールウィンドウ](debug-tool-window.html)に切り替え、通常どおり進めます。 [プログラムをステップ実行](stepping-through-the-program.html)、 [プログラムの実行を停止して再開](null)、 [中断時にそれを調べる](examining-suspended-program.html)、コールスタックと変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM の表示](viewing-actual-html-dom.html)などが可能です。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

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

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

Procedure:

1. コードに [ブレークポイントを設定](using-breakpoints.html)します。

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

3. 実行   ツールウィンドウまたは   ターミナルエミュレータ   には、アプリケーションが実行されている URL が表示されます。 `Ctrl+Shift` (Windows), `Ctrl+Shift` (macOS), `Ctrl+Shift` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift` (macOS System Shortcuts), `Ctrl+Shift` (XWin), `Ctrl+Shift` (GNOME), `Ctrl+Shift` (KDE), `Ctrl+Shift` (Emacs), `Ctrl+Shift` (Sublime Text), `Ctrl+Shift` (Sublime Text (macOS)), `Ctrl+Shift` (Xcode), `Ctrl+Shift` (Visual Studio), `Ctrl+Shift` (Visual Studio (macOS)), `Ctrl+Shift` (ReSharper), `Ctrl+Shift` (ReSharper (macOS)), `Ctrl+Shift` (QtCreator), `Ctrl+Shift` (QtCreator (macOS)), `Ctrl+Shift` (NetBeans), `Ctrl+Shift` (Eclipse), `Ctrl+Shift` (Eclipse (macOS)) を押したまま、この URL リンクをクリックします。 CLion は自動生成された    構成で、タイプ [JavaScript Debug](run-debug-configuration-javascript-debug.html) のデバッグセッションを開始します。

![Starting a debugging session from the Run tool window, the application is running on localhost](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vite_debug_from_tw_localhost_custom_port.animated.gif)

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

![新しいターミナル: ブラウザーでデバッグを開始ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vite_start_debugging_from_new_terminal_start_debugging_button.png)

デフォルトでは、ボタンは表示されていません。 表示するには、   設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）を開き、  `詳細設定`  に移動して、   JavaScript and TypeScript   領域の   ターミナルの localhost リンクに 'ブラウザでデバッグを開始' ボタンを表示する   チェックボックスを選択してください。

> **Note:**
> このボタンは、WSL の   新しいターミナル   では使用できません。

最初のブレークポイントに到達したら、 [デバッグツールウィンドウ](debug-tool-window.html)に切り替え、通常どおり進めます。 [プログラムをステップ実行](stepping-through-the-program.html)、 [プログラムの実行を停止して再開](null)、 [中断時にそれを調べる](examining-suspended-program.html)、コールスタックと変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM の表示](viewing-actual-html-dom.html)などが可能です。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

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

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

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

* `パッケージ.json​​` の `dev` スクリプトを更新します。 ```JSON "dev": "vite --host=127.0.0.1" ```

* あるいは、 `dns.setDefaultResultOrder('ipv4first')` を `vite.config.ts` に追加します。

