WSL2＋Dockerで作るWindows開発環境構築まとめ

WindowsマシンでWeb開発やバックエンド開発、AIアプリ開発を行う際、いまや欠かせない標準構成となったのが「Windows ＋ WSL2 ＋ Docker ＋ VS Code」の組み合わせです。

かつては「Web開発といえばMac一択」「WindowsでのLinux環境やDockerは遅くてトラブルが多い」と言われていた時代もありました。しかし、WSL2（Windows Subsystem for Linux 2）の劇的な進化や最新のファイルシステム（virtiofs）、ネットワーク改善、そしてDocker Desktopに依存しない軽量なコンテナ環境（WSL Containersなど）の登場により、現在のWindowsは極めて快適で高速な最強の開発マシンへと進化を遂げています。

しかし、これから環境を作る方や以前挫折した方にとっては、「WSL2とDockerはどう連携しているのか」「Docker Desktopの有料化やメモリ爆食いをどう回避すべきか」「どこでトラブルが起きやすいのか」といった疑問や不安も多いはずです。

この記事では、Windows上でモダンかつ爆速な開発環境を一から構築するロードマップをステップ順に完全解説します。

当ブログ（Snow System）に掲載されている60本以上の実践的なWSL2・Docker・Windowsカスタマイズ記事へも各章からダイレクトにリンクしていますので、体系的な導入ガイドとして、また日々の開発・エラー解決のハンドブックとしてご活用ください。

1. Windows開発環境の全体アーキテクチャ
1. なぜネイティブWindowsではなく「WSL2上のLinux」なのか？
2. Step 1：WSL2（Ubuntu）の導入と初期セットアップ
3. Step 2：WSL2の高速化＆メモリ・ネットワーク最適化
1. 推奨の .wslconfig 設定例
2. チューニングのポイントと詳細記事
4. Step 3：Docker環境の選択と構築
5. Step 4：実践Docker活用（Webアプリ・DB・コンテナ連携）
1. よく使うコマンド（Docker / Compose v2）
2. 実践環境構築パターン
6. Step 5：AIエディタ（Cursor / VS Code）とDev Containers連携
1. WSL2・Dockerとシームレスに繋ぐエディタ環境
7. Step 6：開発効率を何倍にも引き上げる周辺ツール＆設定
8. 【逆引き】WSL2＆Dockerの頻出エラー解決辞典
1. WSL2 / VS Code 関連のエラー
2. Docker / ネットワーク関連のエラー
本格的なサーバー運用ならVPSがおすすめ
9. まとめ
参考情報

1. Windows開発環境の全体アーキテクチャ

まずは、私たちが構築する「Windowsモダン開発環境」の全体構造と、各ツールの役割を把握しておきましょう。

![](wsl2-docker-architecture.png)

なぜネイティブWindowsではなく「WSL2上のLinux」なのか？

本番環境（Linuxサーバー）との完全な互換性
– Webサーバーやクラウド（AWS/GCP/Docker）の多くはLinuxで動作しています。OSごとのパスの区切り文字や改行コード、権限（パーミッション）の差異によるトラブルを完全に排除できます。
VS Codeの「Remote – WSL」によるシームレスな体験
– ソースコードやツールはWSL2のLinux側に置きつつ、エディタ画面やGUI操作はWindows側のVS Codeからネイティブアプリ同等のレスポンスで操作できます。

全体像の詳しい解説：Windowsプログラミング開発環境の構築手順
OS移行レビュー：プログラミング開発環境をWindows 10からWindows 11へ変更してみた

2. Step 1：WSL2（Ubuntu）の導入と初期セットアップ

まずは土台となるWSL2とUbuntuをセットアップします。現在ではコマンド1行で簡単にセットアップ可能です。

WSL2とUbuntuのインストール手順

管理者権限でPowerShellを開き、以下のコマンドを実行してPCを再起動します。

wsl --install -d Ubuntu

再起動後、Ubuntuのコンソールが起動し、初期ユーザー名とパスワードの設定を求められます。

詳しいインストール手順：Windows 10/11にWSL2をインストールする手順まとめ
バージョン指定インストール：WSL2にUbuntuをインストールする手順

systemd（systemctl）の有効化

現在のWSL2では、Linux標準のサービス管理デーモン「systemd」が利用可能です。バックグラウンドでデーモンやサービスを動かすために有効化しておきましょう。

Ubuntu内の /etc/wsl.conf に以下を追記します。

[boot]
systemd=true

設定と確認手順：WSL2のUbuntuでsystemctlを利用する方法

Windowsエクスプローラーとの相互アクセス

WSL2内のファイルは、Windowsのエクスプローラーから \\wsl$\Ubuntu で直接開くことができます。また、Ubuntuのターミナルから explorer.exe . と入力すると、現在のディレクトリがエクスプローラーで開きます。

エクスプローラー連携：エクスプローラーでWSL2のディレクトリを開く方法

3. Step 2：WSL2の高速化＆メモリ・ネットワーク最適化

WSL2をデフォルトのまま使い続けると、「メモリを際限なく消費してしまう」「Windows側とLinux側のファイルやり取りが遅い」といった問題に直面します。

Windowsのホームディレクトリ（C:\Users\<ユーザー名>\）に .wslconfig ファイルを作成し、適切な最適化設定を行いましょう。

推奨の .wslconfig 設定例

[wsl2]
# メモリ上限をホストの50〜60%程度に制限
memory=8GB
# プロセッサ数の割り当て
processors=4
# スワップ領域の割り当て（SSDの無駄な消耗を防ぐ）
swap=4GB

[experimental]
# virtiofsでファイルアクセスを爆速化（Windows 11）
autoMemoryReclaim=gradual
sparseVhd=true
networkingMode=mirrored

チューニングのポイントと詳細記事

virtiofsによるファイルアクセスの爆速化:
新しい仮想ファイルシステム「virtiofs」を有効にすると、I/O性能が大幅に向上します。
解説：【WSL2爆速化】新機能「virtiofs」でファイルアクセス速度を向上させる方法
ネットワークの「ミラーリングモード」:
networkingMode=mirrored を設定することで、Windows側の localhost とWSL2側の localhost が完全に同期し、ポートフォワーディングの手間が不要になります。
解説：WSL2の「ミラーリングモード」とネットワーク高速化設定完全ガイド
メモリ上限固定とスワップ設定:
WSL2のメモリ食い潰しを防ぎ、不要なスワップを制御します。
解説：WSL2に割り当てるメモリサイズを手動で固定設定する方法
解説：WSL2でswapをoffにする方法
安全なシャットダウン・再起動:
設定変更後は wsl --shutdown で一度WSL2を完全に終了させてから再起動します。
手順：WSL2を再起動する正しい手順｜wslコマンドの使い方と注意点
仮想ディスク（vhdx）の圧縮と自動解放（sparseVhd）:
WSL2の利用に伴い肥大化する仮想ディスク（ext4.vhdx）を圧縮し、Cドライブの空き容量を取り戻す手順です。
手順：WSL2の肥大化したvhdxを圧縮してCドライブ容量を空ける方法

4. Step 3：Docker環境の選択と構築

2026年現在、WindowsでDockerを利用するアプローチにはいくつかの選択肢が存在します。プロジェクトの規模やライセンス条件に合わせて最適な手法を選択しましょう。

WindowsにおけるDocker利用手法の比較

手法	メリット	注意点・デメリット	おすすめ対象
WSL Containers （wslc）	追加アプリ不要（`wsl --update` で更新） Docker Desktop不要でVS Code連携可能	Docker Compose相当（`wslc compose`）は未提供。OS要件は公式で確認	個人開発、メモリを節約したいエンジニア
WSL2直接インストール（Docker Engine）	完全無料・Linux標準の操作感	自動起動やGUIダッシュボードなし	サーバー同様のCLI運用に慣れたい人
Docker Desktop	洗練されたGUI・導入が最も簡単	企業利用時は有料ライセンスが必要・メモリ消費大	チーム指定がある場合、GUI操作重視の人
Podman	デーモンレス・rootlessでセキュア	Docker CLIと微妙なオプション差異	セキュリティ要件の厳しい企業環境

4大手法の徹底比較：【2026最新】WindowsでDockerを使う4手法を比較｜WSL2・Desktop・Podman
実測ベンチマーク：wslc vs Docker Desktop：メモリ消費・起動速度を実測比較

Docker Desktop不要！WSL Containers（wslc）の活用

「Docker Desktopの有料化やメモリ消費を避けたい」という方には、Windows標準のコンテナ機能である「WSL Containers（wslc）」が最適です。2026年9月には「WSL 3.0」のリリースに伴い、正式版（GA）として一般提供が開始されました。

最新バージョン・全体像：【WSL 3.0】WSL2との違いと導入手順｜正式版コンテナの使い方
仕組みと導入手順：WSL containersでDocker Desktop不要に｜仕組みと使い方・ローカルLLM構築
VS Code連携：wslcでVS Code Dev Containers連携する全手順
Dockerfileビルド：wslc buildでDockerfileからカスタムイメージを作る方法

Ubuntu内へのDocker Engine・docker-compose導入

WSL2内のUbuntuに直接Docker Engineを導入する王道の手順です。

Docker導入：UbuntuへDockerをインストールする基本手順
Compose導入：docker-composeのインストール手順まとめ

5. Step 4：実践Docker活用（Webアプリ・DB・コンテナ連携）

Docker環境が整ったら、実際の開発でよく使う構成パターンを構築してみましょう。

よく使うコマンド（Docker / Compose v2）

現在のDocker Composeは、ハイフンなしの docker compose（v2）が標準です。

# コンテナのビルドとバックグラウンド起動
docker compose up -d --build

# 起動中のコンテナ状態確認
docker compose ps

# ログをリアルタイム追跡
docker compose logs -f

# コンテナの停止と削除
docker compose down