WebStorm 2025.3 ヘルプ

WSL

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

プロジェクト用に WSL ツールチェーンを設定すると、Windows マシンで実行されている WebStorm を移動せずに、Linux のツールチェーンを使用してビルドし、WSL で実行 / デバッグできます。

WSL を設定する

  1. 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. ウェルカム画面で、新規プロジェクトをクリックします。

    Create a project in WSL: Welcome screen
  3. 開いているダイアログで:

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

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

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

      Specify Node.js

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

      Configure WSL Node.js runtime: select Add WSL

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

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

  4. 作成をクリックします。

    Create a project in WSL

    WebStorm は WSL にプロジェクトを作成し、IDE を移動せずに WSL 環境内でプロジェクトを開発およびビルドできます。

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

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

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

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

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

    Opening a project stored in the WSL file system

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

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

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

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

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

    Configuring Node.js on WSL as the default project Node.js runtime

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

    The newly configured Node.js runtime is added to the list and set as default for the current project

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

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

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

    Run and debug applications in WSL: create a run/debug configuration
  2. アプリケーションを実行するには、実行ウィジェットから新しく作成された実行 / デバッグ構成を選択し、その横にある the Run button をクリックします。

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

    Debug applications in WSL: start a debugging session
2026 年 1 月 22 日

関連ページ:

WebStorm をインストールする

WebStorm では、JavaScript、TypeScript、関連テクノロジをすぐにサポートできるほか、さまざまな統合開発者ツールを備えているため、コーディングに直接取り組むことができ、日常的なタスクに費やす時間を節約できます。システム要件:RAM2 GB の空き RAM8 GB の総システム RAMCPU 最新の CPU マルチコア CPU。WebStorm は、さまざまな操作やプロセスのマルチスレッドをサポートしているため、使用できる CPU コアが多くなります。ディスク容量 3.5 GB...

リモート Node.js ランタイムの構成

WebStorm では、リモートホストまたは仮想環境にインストールされた Node.js 上でアプリケーションを開発、テスト、リント、実行、デバッグする場合、リモート Node.js ランタイムを構成する必要があります。リモート Node.js ランタイムは、Node.js リモートインタープリターの構成ダイアログで設定します。このダイアログは、設定ダイアログの JavaScript ランタイムページから、またはそれ以降に、リモート環境でアプリケーションを実行またはデバッグするための Node.j...

言語およびフレームワーク

WebStorm は、JavaScript およびその他の多くの関連テクノロジをそのままサポートしています。以下に、サポートされている言語、フレームワーク、テクノロジーのリストと、対応するチュートリアルへのリンクを示します。言語 JavaScript,TypeScript,HTML,Markdown,XML,JSON,YAML, シェルスクリプト。スタイルシート CSS,Sass、SCSS、Less,Tailwind CSS. フレームワークおよびライブラリ React,Angular,Vue, ヌクスト ,...

パス選択ダイアログ

パスの選択ダイアログでは、さまざまな状況でファイルまたはフォルダーの場所を指定できます。たとえば、実行する実行可能ファイル、使用する構成ファイル、テストまたはインスペクションの結果をエクスポートするファイルを指定する必要がある場合があります。ダイアログの名前と利用可能なオプションは、実行しているタスクによって異なります。現在のコンテキストで適用できない機能は通常無効になっています。たとえば、1 つの項目しか選択できない場合もあれば、複数の項目を選択できる場合もあります。また、フォルダーは選択でき...

Node.js

Node.js は、サーバーやコマンドラインなど、ブラウザーの外部で JavaScript を実行するための軽量ランタイム環境です。WebStorm は Node.js と統合されており、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、保守を支援します。Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、Node.js をインストール...

Node.js の実行とデバッグ

WebStorm は、Node.js アプリケーションの実行とデバッグを支援します。WebStorm から起動し、すでに実行中のアプリケーションにアタッチするアプリケーションをデバッグできます。始める前に:設定 | プラグインページのインストール済みタブで、Node.js および JavaScript Debugger に必要なプラグインが有効になっていることを確認します。詳細については、「プラグインのマッピング」を参照してください。Node.js アプリケーションを実行する:WebStorm は...