WSL蔵
WSL (WSL 2) – Windows Subsystem for Linux – は、Windows 10 以降で Linux バイナリ実行ファイルをネイティブに実行するための互換性レイヤーです。 現在、Ubuntu、OpenSUSE、SLES など、いくつかの Linux ディストリビューション(英語)をサポートしています。
プロジェクトに WSL ツールチェーン を設定すると、Linux のツールチェーンを使ってビルドし、Windows マシン上で WebStorm を起動したまま、WSL で実行・デバッグできます。
WSL を設定する
Windows マシンで Microsoft ストア から WSL ディストリビューション(例えば Ubuntu)をダウンロードしてインストールします。
この手順では、最新の「Fall Creators Update」(最小バージョン 1709、ビルド 16299.15) を適用した少なくとも Windows 10 以降を使用してください。 手順については、公式ガイド Linux 用の Windows サブシステムをインストールするを参照してください。
WSL 2. を使用するには、Windows のバージョンが 10 ビルド 18917 以降である必要があります。 これらの手順(英語)に従って、ディストリビューションを切り替えます。
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 をインストールするを参照してください。
コマンドラインシェルまたは組み込みの ターミナル (Alt+F12 )を開きます。
cURLをインストールします。sudo apt-get install curlnvmをインストールします。curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash次のいずれかのコマンドを実行して Node.js をインストールします。
nvm install --lts安定した Long Term Service Node.js バージョンをインストールするインストールする
nvm install nodeまたは現在のリリースバージョン
プロジェクトを作成して WSL 環境に保存し、WSL ファイルシステムからプロジェクトを開き、WSL でさらに開発することができます。
WSL ファイルシステムで新しいプロジェクトを作成する
通常どおり Windows 上でローカルに インストールして実行 WebStorm を使用します。
ウェルカム画面で、 新規プロジェクト をクリックします。

開いているダイアログで:
左側のペインのリストからプロジェクトタイプを選択します。
右側のペインで、プロジェクト名と場所を指定します。 WSL のプロジェクトの場所には、WSL ファイルシステムへの \\wsl$ で始まる絶対パスが表示されます。

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

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

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

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

WebStorm は WSL にあるプロジェクトを作成し、IDE から離れることなく WSL 環境内でプロジェクトを開発およびビルドできます。
WSL ファイルシステムに保存されているプロジェクトを開く
WebStorm では、WSL ファイルシステムに保存されているプロジェクトを直接開いて、他のプロジェクトと同じように扱うことができます。
Welcome 画面で 開く をクリックするか、メインメニューから を選択してください。
開いた パスの選択ダイアログで、開くプロジェクトが含まれている WSL ファイルシステム内のフォルダーを選択するか、プロジェクトの場所へのパスを手動で入力します。
パス構文は
\\wsl.localhost\DistributionNameです。ここで、DistributionNameはLinuxディストリビューションの名前(例:Ubuntu、Debian、Archなど)です。
プロジェクトの場所を構成する
作成または開くすべてのプロジェクトで適切な WSL の場所が使用されるようにできます。
WSL ベースの Node.js ランタイムを構成する
Node.js インストールを 現在のプロジェクトのデフォルトのランタイムとして設定することも、この Node.js バージョンを Node.js 実行 / デバッグ構成で構成して使用することもできます。
設定 ダイアログ(Ctrl+Alt+S )で に移動します。
Node.js ランタイム ダイアログで ノードランタイム フィールドの横にある
をクリックし、
をクリックして、リストから WSL を追加 を選択します。

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

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

プロジェクトを実行してデバッグする
アプリケーションを実行またはデバッグすると、WSL で実行されます。 実行構成を開くと、WebStorm が 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 ) を選択します。 例:
WSL 上の Git
Linux シェルスクリプト
Linux ベースのビルドツール
WSL 統合を使用する Docker
Linux ベースのテストおよび開発サーバー
このアプローチの主な利点は、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 にマウントされたパス経由でファイルをウォッチするため、ホットリロードや一部の読み取り/書き込み操作の信頼性が低くなることがあります:
追加の Input/Output オーバーヘッドがあるため、 強く推奨します: ビルドシステム、 node_modules 、Git 中心のワークフローでは、このクロスファイルシステム構成を避けてください。
特にホットリロードでは、通常の回避策は、ファイルウォッチャーをネイティブイベントからポーリングに切り替えることです。つまり、開発サーバーがファイル、たとえば変更タイムスタンプを定期的にチェックして、変更されたかどうかを確認します。
Vite が WSL2 で実行され、ファイルが Windows プロセスによって編集される場合、ファイルウォッチングが機能しないことがあり、
usePolling: trueがフォールバックになります。 トレードオフとして、CPU 使用率が高くなります。export default defineConfig({ server: { watch: { usePolling: true, }, }, })ポーリングベースのウォッチ構成を使用します:
module.exports = { watchOptions: { poll: 1000, // Check for changes every second }, };デフォルトまたは特定の間隔でポーリングを使用します。
const wp = new Watchpack({ poll: true // Check for changes at a default interval });または:
const wp = new Watchpack({ poll: 1000 });- 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 開発サーバーを実行する
C:\projects\my-app の Windows ファイルシステム上に Vite プロジェクトを作成します。
プロジェクトの package.json に、Vite 開発サーバーを起動するスクリプトが含まれていることを確認します:
{ "scripts": { "dev": "vite" } }WSL から開発サーバーを実行します。
WSL ではプロジェクトは /mnt/c/projects/my-app として認識されます。
vite.config.ts でポーリングを有効にします:
import { defineConfig } from 'vite' export default defineConfig({ server: { watch: { usePolling: true, }, }, })WSL ターミナルからプロジェクトに移動し、Vite を起動します:
cd /mnt/c/projects/my-app npm install npm run devVite は通常
http://localhost:5173/で開発サーバーを起動しますWindows の WebStorm で、アプリケーションコード、たとえば src/App.tsx を編集します。 構成ファイル (
usePolling: true) でポーリングが有効になっているため、WSL で実行中の Vite は、ファイルシステム変更イベントだけに依存せず、プロジェクトファイルの変更を定期的にチェックします。 Vite が変更を検出すると、必要に応じて HMR (Hot Module Replacement) をトリガーするか、ページをリロードします。
