WSL2設定ガイド：WSL2のパフォーマンス改善：設定と運用による最適化

WSL2のパフォーマンスに関する課題

WindowsでLinux環境を手軽に利用できるWSL2は、多くの開発者にとって手放せないツールとなりました。
しかし、「WSL2を使い始めたけど、なんだか動作が遅い…」「メモリを大量に消費してPC全体が重くなる…」といった悩みを抱えている方も少なくないでしょう。

もしWSL2のパフォーマンスに課題を感じ、より快適な開発環境を求めているなら、この記事が参考になるでしょう。

WSL2のパフォーマンスに課題を感じることは少なくありません。しかし、適切な設定と運用により、快適な開発環境を構築することは可能です。

この記事では、WSL2のパフォーマンスボトルネックを理解し、具体的な設定変更や運用方法を通じて、WSL2開発環境を最適化するための実践的な方法を解説します。
WSL2の性能を最大限に活用し、快適な開発体験を目指しましょう！

目次

• WSL2パフォーマンスのボトルネックを理解する
  • ファイルI/O性能の課題
  • メモリ・CPUリソースの消費
• .wslconfig でリソースを最適化する
  • memory, processors, swap の設定
  • localhostForwarding と vmIdleTimeout の活用
• ファイルシステムアクセスのベストプラクティス
  • プロジェクトはLinuxファイルシステム内に
  • Windows Defenderの除外設定
• メモリとディスク容量の管理術
  • wsl --shutdown の活用
  • メモリキャッシュの手動解放
  • ディスク容量の最適化
• まとめ：快適なWSL2開発環境を手に入れる

対象読者

• WSL2の動作が遅い、重いと感じている開発者
• WSL2のパフォーマンスを改善するための具体的な設定や運用方法を知りたい方
• WSL2のリソース管理やファイルシステムアクセスについて最適化したい方
• WSL2をより快適に、効率的に利用したい方

WSL2パフォーマンスのボトルネックを理解する

WSL2のパフォーマンスが低下する主な原因は、以下の2点に集約されます。これらを理解することが、パフォーマンス最適化の第一歩です。

ファイルI/O性能の課題

WSL2は仮想マシン上でLinuxを実行しているため、Windows側のファイルシステム（例: C:\Users\yourname\project）に配置されたファイルをLinux側からアクセスすると、パフォーマンスが著しく低下します。これは、WindowsとLinux間のファイルシステム変換オーバーヘッドが大きいためです。

例えば、node_modules のインストールやDockerイメージのビルドなど、大量のファイルを扱う操作では、このファイルI/O性能の課題が顕著に現れ、処理に時間がかかることがあります。
詳細については、Microsoft LearnのWSLドキュメントを参照してください。

メモリ・CPUリソースの消費

WSL2はデフォルトで、Windowsが利用可能なメモリとCPUリソースの一部を動的に割り当てます。しかし、WSL2上で複数のディストリビューションを起動したり、Dockerコンテナを多数実行したりすると、これらのリソースが過剰に消費され、Windows全体の動作が重くなることがあります。特に、Vmmem プロセスが大量のメモリを消費していることに気づく方もいるかもしれません。

.wslconfig でリソースを最適化する

WSL2のパフォーマンスを改善するための重要な設定ファイルの一つが、Windowsのユーザープロファイルディレクトリに配置される .wslconfig です。このファイルを使って、WSL2に割り当てるリソースを細かく制御できます。
詳細については、Microsoft LearnのWSLドキュメントを参照してください。

memory, processors, swap の設定

.wslconfig で設定できる主要なリソース割り当て項目は以下の通りです。

• memory: WSL2に割り当てる最大メモリ量を指定します。デフォルトではWindowsの総メモリの約80%が上限となりますが、これを明示的に設定することで、WSL2がメモリを過剰に消費するのを防ぎ、Windows側の安定性を保てます。
  • 例: memory=4GB (4GBを上限とする)
• processors: WSL2に割り当てるCPUコア数を指定します。物理コア数や論理コア数を考慮し、適切な値を設定することで、WSL2の処理性能とWindows側の応答性のバランスを取れます。
  • 例: processors=4 (4コアを割り当てる)
• swap: WSL2のLinux環境で使用するスワップファイルのサイズを指定します。物理メモリが不足した場合に備えて設定しますが、SSDなどの高速ストレージを使用している場合は、過剰なスワップはパフォーマンス低下を招くため、適切なサイズに調整することが重要です。
  • 例: swap=2GB (2GBのスワップファイルを使用する)

.wslconfig 設定例:

[wsl2]
memory=8GB  # WSL2に割り当てる最大メモリを8GBに制限
processors=6 # WSL2に割り当てるCPUコア数を6に制限
swap=2GB    # スワップファイルを2GBに設定
localhostForwarding=true # ホストのlocalhostポートをWSL2に転送
vmIdleTimeout=300 # アイドル状態が300秒続いたらWSL2を自動停止

[wsl2]
memory=8GB  # WSL2に割り当てる最大メモリを8GBに制限
processors=6 # WSL2に割り当てるCPUコア数を6に制限
swap=2GB    # スワップファイルを2GBに設定
localhostForwarding=true # ホストのlocalhostポートをWSL2に転送
vmIdleTimeout=300 # アイドル状態が300秒続いたらWSL2を自動停止

localhostForwarding と vmIdleTimeout の活用

• localhostForwarding=true: Windows側で起動したアプリケーションのポートをWSL2側から localhost でアクセスできるようにします。開発時の利便性が向上します。
• vmIdleTimeout: WSL2がアイドル状態になった際に、自動的にシャットダウンするまでの時間を秒単位で指定します。これにより、不要なリソース消費を防ぎ、Windows側のパフォーマンスを維持できます。

これらの設定を適切に行うことで、WSL2のリソース消費を最適化し、WindowsとWSL2の両方で快適な動作を実現できます。

ファイルシステムアクセスのベストプラクティス

WSL2のパフォーマンスを語る上で、ファイルシステムアクセスの最適化は避けて通れません。

プロジェクトはLinuxファイルシステム内に

前述の通り、Windows側のファイルシステムに配置されたファイルをLinux側からアクセスすると、ファイルI/O性能が著しく低下します。これを避けるためには、開発プロジェクトのファイルをWSL2のLinuxファイルシステム内（例: /home/yourname/project）に配置することが推奨されます。

VS CodeのRemote – WSL拡張機能を使用すれば、Linuxファイルシステム内のプロジェクトをWindows側のVS Codeからシームレスに編集できます。これにより、Windowsの使い慣れたエディタ環境を維持しつつ、Linuxネイティブの高速なファイルI/O性能を享受できます。

Windows Defenderの除外設定

Windows Defenderなどのリアルタイム保護機能がWSL2の仮想ディスクファイル（ext4.vhdx）をスキャンすると、パフォーマンスに悪影響を与えることがあります。WSL2の仮想ディスクファイルが保存されているディレクトリをWindows Defenderの除外設定に追加することで、このオーバーヘッドを削減できる場合があります。ただし、この設定はMicrosoftによって明示的に推奨されているわけではなく、セキュリティリスクを伴う可能性があるため、慎重に判断する必要があります。

通常、仮想ディスクファイルは %LOCALAPPDATA%\Packages\<DistroName>\LocalState のようなパスに存在します。正確なパスは wsl --list --verbose コマンドで確認できます。
Windows Defenderの除外設定に関する詳細は、Microsoft Learnのドキュメントを参照してください。

メモリとディスク容量の管理術

リソースの最適化だけでなく、適切な管理もWSL2の快適な運用には不可欠です。

wsl --shutdown の活用

WSL2はデフォルトで起動し続けるため、使用していない間もリソースを消費します。開発作業を終えたら、コマンドプロンプトやPowerShellで wsl --shutdown を実行することで、全てのWSL2ディストリビューションを停止し、リソースを解放できます。これにより、Windows側のパフォーマンスが回復します。

メモリキャッシュの手動解放

Linuxカーnelは、ファイルI/O性能向上のために未使用メモリをキャッシュとして積極的に利用します。これにより、一時的にメモリ使用量が高く表示されることがありますが、これは問題ではありません。しかし、Windows側のメモリが逼迫している場合は、Linux側でメモリキャッシュを手動で解放することで、Windowsにメモリを返還できます。

WSL2のLinuxターミナルで以下のコマンドを実行します。

sudo sh -c 'echo 3 > /proc/sys/vm/drop_caches'

sudo sh -c 'echo 3 > /proc/sys/vm/drop_caches'

注意: このコマンドは一時的にパフォーマンスに影響を与える可能性があります。必要な場合にのみ実行してください。

【WSL2の自動メモリ回収機能】

WSLバージョン2.0.0以降では、自動メモリ回収（Automatic Memory Reclaim）機能が導入されています。.wslconfigファイルに autoMemoryReclaim=dropcache を設定することで、アイドル時にLinuxのキャッシュメモリを自動的に解放し、Windowsホストが再利用できるようになります。
詳細については、Microsoft LearnのWSLドキュメントなどを参照してください。

ディスク容量の最適化

WSL2の仮想ディスクは、使用するにつれてサイズが肥大化することがあります。不要なファイルを削除した後も、仮想ディスクのサイズが縮小されない場合は、wsl --vhd --compact コマンドを使用して仮想ディスクを最適化できます。このコマンドは、diskpart や Optimize-VHD を使用するよりも新しい方法で、より簡潔にディスクを圧縮できます。
詳細については、Microsoft LearnのWSLドキュメントを参照してください。

1. まず、全てのWSL2ディストリビューションをシャットダウンします。

wsl --shutdown

wsl --shutdown

2. PowerShellまたはコマンドプロンプトで、仮想ディスクのパスを確認します。

wsl --list --verbose

wsl --list --verbose

出力される VHDX ファイル のパスをメモします。

3. 仮想ディスクを最適化します。

wsl --vhd <VHDXファイルのパス> --compact

wsl --vhd <VHDXファイルのパス> --compact

例: wsl --vhd "C:\Users\yourname\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_...\LocalState\ext4.vhdx" --compact

これにより、仮想ディスクの物理的なサイズが縮小され、ディスク容量を節約できます。

まとめ：快適なWSL2開発環境を手に入れる

WSL2のパフォーマンス最適化は、単一の設定変更で劇的に改善するものではなく、複数の側面からのアプローチが必要です。

この記事で解説したベストプラクティスを実践することで、WSL2のパフォーマンスに関する課題を解決し、WindowsとLinuxの利点を活かした、快適で生産性の高い開発環境を構築できるでしょう。

今日からできること:

1. .wslconfig を見直し、メモリとCPUリソースを最適化する。
2. 開発プロジェクトは必ずWSL2のLinuxファイルシステム内に配置する。
3. Windows Defenderの除外設定を確認する。
4. 不要な時は wsl --shutdown でリソースを解放する。
5. 定期的にディスク容量を最適化する。

これらのステップを踏むことで、WSL2の動作がより軽快になることが期待できます。
WSL2に関する疑問や、独自のベストプラクティスがあれば、ぜひコメントで共有してください。

免責事項

本記事の内容は、公開時点での情報に基づいています。WSL2および関連技術は常に進化しており、将来的に情報が古くなる可能性があります。本記事の内容を利用したことによるいかなる損害についても、著者は一切の責任を負いません。ご自身の判断と責任においてご利用ください。