WebStorm 2026.3 Help

WSL​​蔵

WSL (WSL 2) – Windows Subsystem for Linux – は、Windows 10 以降で Linux バイナリ実行ファイルをネイティブに実行するための互換性レイヤーです。 現在、Ubuntu、OpenSUSE、SLES など、いくつかの Linux ディストリビューション(英語)をサポートしています。

プロジェクトに WSL ツールチェーン を設定すると、Linux のツールチェーンを使ってビルドし、Windows マシン上で WebStorm を起動したまま、WSL で実行・デバッグできます。

WSL を設定する

  1. Windows マシンで Microsoft ストア から WSL ディストリビューション(例えば Ubuntu)をダウンロードしてインストールします。

    この手順では、最新の「Fall Creators Update」(最小バージョン 1709、ビルド 16299.15) を適用した少なくとも Windows 10 以降を使用してください。 手順については、公式ガイド Linux 用の Windows サブシステムをインストールするを参照してください。

    WSL 2. を使用するには、Windows のバージョンが 10 ビルド 18917 以降である必要があります。 これらの手順(英語)に従って、ディストリビューションを切り替えます。

  2. Linux ディストリビューションを実行します。

    最初の起動時に、システムは Windows のオプション機能を有効にするように求めるメッセージを表示する場合があります。 この場合、次のことを行う必要があります。

    • 管理者として Windows PowerShell を開き、実行します

      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
    • コンピューターを再起動してください。

Node.js と npm をインストールする

Linux(Ubuntu) インストール内で、nvm、Node、js、npm がインストールされていることを確認してください。 インストール手順の詳細については、 Linux の Windows サブシステムに Node.js をインストールするを参照してください。

  1. コマンドラインシェルまたは組み込みの ターミナル (Alt+F12 )を開きます。

  2. cURL をインストールします。

    sudo apt-get install curl
  3. nvm をインストールします。

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
  4. 次のいずれかのコマンドを実行して Node.js をインストールします。

    • nvm install --lts 安定した Long Term Service Node.js バージョンをインストールする

    • インストールする nvm install node または現在のリリースバージョン

プロジェクトを作成して WSL 環境に保存し、WSL ファイルシステムからプロジェクトを開き、WSL でさらに開発することができます。

WSL ファイルシステムで新しいプロジェクトを作成する

  1. 通常どおり Windows 上でローカルに インストールして実行 WebStorm を使用します。

  2. ウェルカム画面で、 新規プロジェクト をクリックします。

    WSL でプロジェクトを作成する: ウェルカム画面
  3. 開いているダイアログで:

    1. 左側のペインのリストからプロジェクトタイプを選択します。

    2. 右側のペインで、プロジェクト名と場所を指定します。 WSL のプロジェクトの場所には、WSL ファイルシステムへの \\wsl$ で始まる絶対パスが表示されます。

      WSL でプロジェクトの場所を選択する
    3. ほとんどの場合、WebStorm は Node.js の場所を指定するように求めます。 Node.js がまだない場合は、リストから ダウンロード を選択します。 または、 追加 を選択して WSL Node.js インタープリターを構成します。

      Node.js を指定する

      次に、ポップアップから WSL を追加 を選択します。

      WSL Node.js ランタイムを構成する: WSL の追加を選択

      開いた WSL ノードランタイムを追加する ダイアログで、現在使用されている Linux ディストリビューションと Node.js へのパスを指定します。

      WSL Node.js ランタイムを追加するダイアログ
    4. 右側のペインの他のフィールドに入力します。 フィールドのセットは、選択したプロジェクトタイプによって異なります。 詳細については、 その他の言語およびフレームワーク の対応記事を参照してください。

  4. 作成 をクリックしてください。

    WSL でプロジェクトを作成する

    WebStorm は WSL にあるプロジェクトを作成し、IDE から離れることなく WSL 環境内でプロジェクトを開発およびビルドできます。

WSL ファイルシステムに保存されているプロジェクトを開く

WebStorm では、WSL ファイルシステムに保存されているプロジェクトを直接開いて、他のプロジェクトと同じように扱うことができます。

  1. Welcome 画面で 開く をクリックするか、メインメニューから ファイル | オープン を選択してください。

  2. 開いた パスの選択ダイアログで、開くプロジェクトが含まれている WSL ファイルシステム内のフォルダーを選択するか、プロジェクトの場所へのパスを手動で入力します。

    パス構文は \\wsl.localhost\DistributionName です。ここで、 DistributionName はLinuxディストリビューションの名前(例:Ubuntu、Debian、Archなど)です。

    WSL ファイルシステムに保存されているプロジェクトを開く

プロジェクトの場所を構成する

作成または開くすべてのプロジェクトで適切な WSL の場所が使用されるようにできます。

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | システム設定 を選択します。

  2. プロジェクト セクションの デフォルトのプロジェクトディレクトリ フィールドで、適切な WSL ディレクトリを指定し、 OK をクリックして変更を保存します。

    デフォルトのプロジェクトディレクトリ

    今後、プロジェクトを 作成、 開く 、または クローンするたびに、指定したディレクトリがデフォルトで選択されます。

WSL ベースの Node.js ランタイムを構成する

Node.js インストールを 現在のプロジェクトのデフォルトのランタイムとして設定することも、この Node.js バージョンを Node.js 実行 / デバッグ構成で構成して使用することもできます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | JavaScript ランタイム> に移動します。

  2. Node.js ランタイム ダイアログで ノードランタイム フィールドの横にある 参照ボタン をクリックし、 追加ボタン をクリックして、リストから WSL を追加 を選択します。

    WSL Node.js ランタイムを構成する: WSL を追加する
  3. 開いている WSL ノードランタイムを追加する ダイアログで、使用している Linux ディストリビューションを選択し、Node.js へのパスを指定します。

    WSL 上の Node.js をプロジェクトのデフォルト Node.js ランタイムとして構成する

    構成された Node.js インストールがリストに追加され、現在のプロジェクトのデフォルトとして設定されます。

    新しく構成された Node.js ランタイムがリストに追加され、現在のプロジェクトのデフォルトとして設定されます。

プロジェクトを実行してデバッグする

アプリケーションを実行またはデバッグすると、WSL で実行されます。 実行構成を開くと、WebStorm が WSL をローカルマシンと呼んでいることに注意してください。

  1. アプリケーションのタイプに応じて、適切なタイプの 実行 / デバッグ構成を作成するを選択します。 そのためには、 実行 | 実行構成の編集 に移動します。 次に、 実行 / デバッグ構成 ダイアログで、ツールバーの をクリックし、必要な実行 / デバッグ構成タイプを選択します。 開いたダイアログで、必要に応じてフィールドに入力するか、定義済みの値を受け入れます。

    WSL でアプリケーションを実行およびデバッグする: 実行 / デバッグ構成を作成する
  2. アプリケーションを実行するには、 実行 ウィジェットから新しく作成された実行 / デバッグ構成を選択し、その横にある Run ボタン をクリックします。

  3. アプリケーションをデバッグするには、必要な場所にブレークポイントを設定し、 実行 ウィジェットから新しく作成された実行 / デバッグ構成を選択し、その横にある 「デバッグ」ボタン をクリックします。

    WSL でアプリケーションをデバッグする: デバッグセッションを開始する

WSLg

WSLg を使用すると、Linux GUI アプリケーションを実行し、その出力を Windows デスクトップに表示できます。

WSLg 経由で WebStorm を実行することは推奨しません。 WebStorm はすでにネイティブ WSL 統合を提供しており、こちらが推奨される方法です。

次の点に注意してください:

  • WSLg には、レンダリング、ポップアップ、ウィンドウ管理、入力メソッド、デスクトップ統合に関する制限があります。

  • WSLg 経由で WebStorm を実行するための専用サポート、インストールガイダンス、オンボーディング、製品固有の修正は提供していません。

プロジェクトを開く方法については WSL ファイルシステムに保存されているプロジェクトを開く を参照し、新規作成する場合は WSL ファイルシステムで新しいプロジェクトを作成する を参照してください。

ヒントとトリック

WSL を日常的な開発ワークフローの一部として使用するには、パフォーマンス、互換性、使いやすさに影響する可能性がある重要な選択がいくつかあります。

ファイルシステムを選択する

WSL を使用して Windows でプロジェクトを作成する場合、基本的な選択肢は、プロジェクトを Windows ファイルシステムに保存する (例: C:\Users\...\project ) か、WSL/Linux ファイルシステム内に保存する (例: ~/projects/project ) かです。 最適な選択は、主に開発ツールとランタイムがどこで実行されるかによって決まります。

開発環境の大部分が Windows でネイティブに実行される場合、つまり次を使用する場合は、Windows ファイルシステム ( C:\Users\me\project ) を選択します:

  • Windows Node.js と npm/yarn/pnpm

  • Windows 版 Git

  • Windows ベースのターミナル

  • Windows パスで動作する Windows Docker ツール

  • プロジェクトファイルへの頻繁な直接アクセスを必要とするその他の Windows アプリケーション

主な利点は、Windows アプリケーションがプロジェクトファイルに通常どおり高速にアクセスできることです。

WSL から Linux ツールを使用してこれらのファイルを操作すると、欠点が現れます。 ファイルは /mnt/c/Users/me/projects/my-app などのパスの下に公開されます。 この Windows/Linux 境界を越えるファイル操作は、特に node_modules のような大量の小さなファイルを含むウェブプロジェクトでは、遅くなることがあります。 ファイルウォッチングも問題が多くなることがあります。

アプリケーションのランタイムと開発ツールチェーンが主に WSL で実行される場合は、WSL ファイルシステム ( /home/me/projects/my-app または単に ~/projects/my-app ) を選択します。 例:

このアプローチの主な利点は、Linux ツールがネイティブ Linux ファイルシステムにアクセスできることです。 このアプローチの主な利点は、Linux ツールがネイティブ Linux ファイルシステムにアクセスできることです。 数千個のファイルを伴う操作、たとえば依存関係のインストール、インデックス作成、コンパイル、テスト、ファイルウォッチングは、一般にその環境でより自然に動作します。

また、開発環境を、継続的インテグレーションや本番環境で一般的に使用される Linux 環境に近づけることもできます。

WebStorm がファイルにアクセスする方法を選択する

プロジェクトファイルが WSL ファイルシステムに保存されている場合、WebStorm がそれらのファイルにアクセスする方法と、バックエンドをどこで実行するかを選択する必要があります。

WebStorm は Windows にインストールされ、 WSL 上のファイルにアクセスします。

この構成は、開発スタック全体を Linux 内で実行することよりも、デスクトップの利便性が重要な場合に最も理にかなっています。

主な利点は、通常の Windows デスクトップアプリケーションを維持できることです: Windows ショートカット、ウィンドウ管理、ブラウザー統合、資格情報ストア、フォント、その他のデスクトップ統合が引き続き自然に動作します。

欠点は、WebStorm とプロジェクトが Windows/Linux 境界の反対側にあることです。 WebStorm のアーキテクチャによっては、インデックス作成、ファイルウォッチング、Git 操作、大規模な依存関係ツリーの解決などの操作で、システム間のファイルアクセスが発生することがあります。

WebStorm は Windows にインストールされ、 リモート開発モードで WSL 上のファイルにアクセスします。

WSL を中心としたウェブ開発ワークフローでは、プロジェクトを WSL に保存し、WSL 上のリモートバックエンドで WebStorm を使用することが、一般的にアーキテクチャ上最も一貫した選択です。

主な利点は Linux ネイティブの開発です。 WSL 中心のワークフローでは、計算負荷の高いプロジェクト操作がファイルに近い WSL 内で行われるため、これは特に魅力的です。 たとえば、IDE バックエンドは ~/projects/my-app のインデックスを作成でき、同時に Node.js、npm、Git、TypeScript、ESLint、その他のツールも WSL で実行されます。

一度に 2 つの利点が得られます: ネイティブな Windows UI と Linux ネイティブのプロジェクト環境です。 Linux セマンティクスを前提とするツールを使用する、Linux シェルスクリプトを使用する、シンボリックリンクや権限に大きく依存する、または大きな node_modules ツリーを持つプロジェクトでは、これは特に有用です。

WebStorm の Linux バージョンは WSL 上のファイルにアクセスします。 WebStorm GUI は WSLg 経由で表示されます。

すべてが同じ Linux 環境で実行されるため、このアプローチは有益に見えますが、WSL 経由で実行される WebStorm の Linux バージョンは、ネイティブ Windows アプリケーションではなく Linux GUI アプリケーションのままです。 そのため、Windows アプリケーション、ブラウザー、資格情報マネージャー、通知、ファイルダイアログ、類似のデスクトップ機能との統合は、シームレスさが低くなる場合があります。

ホットリロードとその他の読み取り/書き込みの問題に対処する

プロジェクトを Windows ファイルシステム上に置いたまま、開発サーバーまたはツールを WSL 内で実行すると、Linux プロセスは通常、Windows にマウントされたパス経由でファイルをウォッチするため、ホットリロードや一部の読み取り/書き込み操作の信頼性が低くなることがあります:

/mnt/c/...

追加の Input/Output オーバーヘッドがあるため、 強く推奨します: ビルドシステム、 node_modules 、Git 中心のワークフローでは、このクロスファイルシステム構成を避けてください。

特にホットリロードでは、通常の回避策は、ファイルウォッチャーをネイティブイベントからポーリングに切り替えることです。つまり、開発サーバーがファイル、たとえば変更タイムスタンプを定期的にチェックして、変更されたかどうかを確認します。

  • Vite

    Vite が WSL2 で実行され、ファイルが Windows プロセスによって編集される場合、ファイルウォッチングが機能しないことがあり、 usePolling: true がフォールバックになります。 トレードオフとして、CPU 使用率が高くなります。

    export default defineConfig({ server: { watch: { usePolling: true, }, }, })
  • webpack

    ポーリングベースのウォッチ構成を使用します:

    module.exports = { watchOptions: { poll: 1000, // Check for changes every second }, };
  • watchpack

    デフォルトまたは特定の間隔でポーリングを使用します。

    const wp = new Watchpack({ poll: true // Check for changes at a default interval });

    または:

    const wp = new Watchpack({ poll: 1000 });
  • chokidar

    import chokidar from 'chokidar'; const watcher = chokidar.watch('.', { usePolling: true });

その他の読み取り/書き込みの問題については、環境をできるだけ一貫した状態に保つことが重要な対策です。 プロジェクトが C:\... にある場合は、WSL から /mnt/c/... を使用し、同じ node_modules に対して Windows 版と Linux 版のパッケージマネージャーを混在させないようにし、権限、大文字と小文字の区別、シンボリックリンク、実行可能ビットに注意してください。 WSL は Windows ファイルを DrvFS 経由でマップします。また、それらのファイルに対する Linux 権限は、ネイティブ Linux ファイルシステム上の権限とまったく同じには動作しません。WSL はオプションで Linux 権限メタデータを Windows ファイルに保存できます。

例: ポーリングを有効にして Vite 開発サーバーを実行する

  1. C:\projects\my-app の Windows ファイルシステム上に Vite プロジェクトを作成します。

  2. プロジェクトの package.json に、Vite 開発サーバーを起動するスクリプトが含まれていることを確認します:

    { "scripts": { "dev": "vite" } }
  3. WSL から開発サーバーを実行します。

    WSL ではプロジェクトは /mnt/c/projects/my-app として認識されます。

  4. vite.config.ts でポーリングを有効にします:

    import { defineConfig } from 'vite' export default defineConfig({ server: { watch: { usePolling: true, }, }, })
  5. WSL ターミナルからプロジェクトに移動し、Vite を起動します:

    cd /mnt/c/projects/my-app npm install npm run dev
  6. Vite は通常 http://localhost:5173/ で開発サーバーを起動します

  7. Windows の WebStorm で、アプリケーションコード、たとえば src/App.tsx を編集します。 構成ファイル (usePolling: true) でポーリングが有効になっているため、WSL で実行中の Vite は、ファイルシステム変更イベントだけに依存せず、プロジェクトファイルの変更を定期的にチェックします。 Vite が変更を検出すると、必要に応じて HMR (Hot Module Replacement) をトリガーするか、ページをリロードします。

2026 年 11 月 6 日