Windows で WSL を使用して開発環境をセットアップする

最終更新： 12/08/2025
著者： アイザック
  • WSL、ディストリビューション、バージョン（WSL 1/2）のインストールと管理 コマンド キーコード。
  • パフォーマンスのベストプラクティス: ストレージ WSLでは、 ターミナル およびリモート エディター。
  • 必須の統合: Git、Docker、 データベース、GPUと apps GUI。

Windows 上の WSL を使用した開発環境

Windowsでプログラミングをしていて、Windowsのツールとワークフローを楽しみたい場合 Linux 重い仮想マシンや ブーツ デュアル、WSLはあなたの最高の味方ですWindows Subsystem for Linux を使用すると、Ubuntu、Debian、openSUSE などのディストリビューションをインストールし、ユーティリティ、シェル、サーバーをネイティブ Linux 上にあるかのように実行できますが、Windows に統合されています。

このガイドでは、WSL を使用して最新の開発環境をセットアップする方法を段階的に説明します。クイック インストール、ディストリビューションの選択、WSL バージョン管理、ユーザー名とパスワード、適切なストレージ プラクティス、ターミナル、VS Code/Visual Studio、Git、Docker、データベース、GPU アクセラレーション、Linux グラフィカル アプリと主要なコマンドについて説明します。さらに、Zsh を使用してシェルをカスタマイズし、nvm を使用して Node.js を管理して、手間をかけずに複数のバージョンを操作する方法も学習します。

前提条件とWindowsバージョンの確認

WSLはWindows 10バージョン2004（ビルド19041）以降でネイティブに動作します。 Windows 11バージョンがわからない場合は、Windows + Rを押して、 winver ビルドに互換性があることを確認します。

簡易インストールコマンドを使用するには wsl --install 最新のビルド（Windows 10 20262+ または現在の Windows 11）を使用することをお勧めします。更新プログラムが不足している場合は、[設定] または Windows Update アシスタントを使用して更新プログラムを適用できます。

コンピューターが WSL 2 をサポートしていない場合は、BIOS/UEFI で仮想化を有効にし、Windows で「仮想マシン プラットフォーム」機能が使用可能であることを確認してください。古い手動インストールから移行したコンピューターでは、WSL Linux カーネルを更新する必要がある場合があります。

超高速WSLインストール

カスタム Linux カーネルと red-2 を使用して WSL2 を構成する方法

最も直接的な方法は、 PowerShellの o コマンドプロンプト 管理者として実行:

wsl --install

このコマンドは、WSL および仮想マシン プラットフォーム コンポーネントを有効にし、Linux カーネルをダウンロードし、WSL 2 をデフォルトに設定し、Ubuntu を自動的にインストールします。インストールを完了するには、Windows の再起動を要求される場合があります。

別のディストリビューションをご希望の場合は、インストール時に以下で指定できます。:

wsl --install -d <NombreDeLaDistro>

オンラインで入手可能なカタログを閲覧するには:

wsl --list --online

古いコンピュータの場合や、きめ細かな制御が必要な場合は、Windowsの機能から手動でインストールするか、カスタムディストリビューションを含むTARをインポートするオプションがあります。それでも、ほとんどのユーザーにとって、 --install それは最も快適な方法です。

最初の起動: Linux のユーザー名とパスワード

インストール後、スタート メニューからディストリビューションを開き (デフォルトでは Ubuntu)、Linux のユーザー名とパスワードを作成します。これらの資格情報は Windows アカウントとは独立しています。

パスワードは「ブラインド」で入力されます（入力時に何も表示されません）。これは完全に正常です。作成されたアカウントはデフォルトとなり、 sudo.

各ディストリビューションには独自のアカウントがあることを覚えておいてください新しいディストリビューションをインストール、再インストール、または追加する場合は、ディストリビューションごとにこのプロセスを繰り返す必要があります。

パスワードを忘れましたか？ PowerShellを開いて次のように入力します。 ルート デフォルトのディストリビューションの場合:

wsl -u root

別の特定のディストリビューションが必要な場合は、その名前を明記してください。:

wsl -d Debian -u root

ルートセッション内で、ユーザーのパスワードをリセットします。:

passwd <usuario>

パスワードが正常に更新されたというメッセージが表示されたら、:

exit

パッケージの更新とメンテナンス

Windows はディストリビューション パッケージを自動的に更新しないため、定期的に更新することをお勧めします。Ubuntu/Debianの場合:

sudo apt update && sudo apt upgrade

システムを最新の状態に保つことで、些細なミスや開発ツールとの互換性の問題を回避できます。初回起動後に推奨される基本ルーチンです。

  Windows の win.ini と system.ini の歴史と機能

ディストリビューションの選択、追加、管理

Microsoft Storeからディストリビューションをインストールすることができます。 wsl --install -d またはカスタムシナリオ用にTAR形式でインポートするWSL ではディストリビューションの数に制限がないので、必要な数だけ使用できます。

インストールされているディストリビューションを一覧表示し、WSLバージョン（1または2）を確認するには、次のコマンドを実行します。:

wsl -l -v

新規インストールで特定のバージョンをデフォルトで使用する場合:

wsl --set-default-version 2

特定のディストリビューションのバージョンを変更するには:

wsl --set-version <NombreDistro> 2

起動時にデフォルトで使用するディストリビューションを選択することもできます。 wsl:

wsl -s <NombreDistro>

デフォルトを変更せずに特定のディストリビューションを直接起動するには:

wsl -d <NombreDistro>

Windowsターミナル: 理想的なマルチコンソールエクスペリエンス

Windows Subsystem for Linux で Bash for Windows スクリプトを作成する

Windowsターミナルは、タブ、パネル、GPUアクセラレーション、Unicode/UTF-8、ショートカット、色、テーマのカスタマイズを提供します。複数のシェル（PowerShell、 CMD、さまざまな WSL ディストリビューション、Azure CLI など) を使用すると、非常に快適であることがわかります。

新しいディストリビューションをインストールするたびに、Windows Terminal がそれを検出し、好みに合わせてプロファイルを微調整できます。複数のコマンドラインで作業する場合、WSL に最適です。

ファイルの保存とパフォーマンス

ファイルエクスプローラーで現在のWSLディレクトリを開きます。:

explorer.exe .

黄金律: プロジェクトは使用するツールのOSのファイルシステムに保存するWSL ターミナルから Linux ツール (gcc、node、python など) を使用している場合は、WSL FS に保存します。

WSLのおすすめルート:

  • WSL: \\wsl$\<NombreDistro>\home\<Usuario>\Proyecto
  • エビータ: C:\Users\<Usuario>\Proyecto o /mnt/c/Users/<Usuario>/Proyecto パフォーマンスへの影響のため、Linux ツールを使用してコンパイル/実行する場合は、

Windows と Linux 間のクロスアクセスは存在しますが、負荷の高いタスクではパフォーマンスが大幅に低下する可能性があります。ワークフローに応じて保存場所を調整します。

コードエディター: VS Code と Visual Studio

Visual Studio Code のリモート開発拡張機能により、WSL が完全な開発環境になります。インストールが完了したら、ディストリビューションのターミナルから次のコマンドでプロジェクトを開きます。

code .

拡張機能、デバッグ、統合ターミナルのエコシステム全体を使ってディストリビューションの「内部」で作業します。さらに、環境（WSL、 SSH 数秒で大量のデータ（またはコンテナ）を処理できます。

クロスプラットフォーム C++ の場合、Visual Studio 2022 は CMake プロジェクトを WSL および SSH 接続と同じインスタンスに統合します。スタックがネイティブ C++ である場合は、価値があります。

Gitと資格情報管理

ディストリビューションにGitをインストールし、名前とメールアドレスを設定する:

sudo apt install -y git
git config --global user.name "Tu Nombre"
git config --global user.email "tu@correo.com"

ハイブリッド Windows/WSL プロジェクトでは、Windows 資格情報マネージャーや VS Code の組み込み機能に依存します。行末（LF/CRLF）の処理と .gitignore 驚きを避けるため。

WSL 2 の Docker を使用したコンテナー

Docker DesktopはWSL 2と統合されており、ネイティブに近いパフォーマンスでLinuxコンテナを実行できます。VS Code からプロジェクトを「リモート - コンテナー」として開き、コンテナー内で開発することができます。

  Wordでテキストを貼り付ける際に改ページや予期しない書式設定を回避する方法

このセットアップにより、再現可能な環境を持つチームを簡単に構築し、基本ディストリビューションを混乱させることなく依存関係を分離できます。複雑なスタックやマイクロサービスに最適です。

WSLのデータベース

WSLは、MySQL、PostgreSQL、MongoDB、Redis、SQLite、さらにはLinux用のSQL Serverをセットアップするのに最適な環境です。ディストリビューションのパッケージ マネージャーからインストールするか、各エンジンの公式ガイドに従ってインストールします。

WSL 内でアプリとベースを動作させることで、レイテンシが短縮され、OS 間の互換性の問題を回避できます。ポートを Windows に公開する必要がある場合は、ネイティブ クライアントから問題なく接続できます。

GPUアクセラレーションと要求の厳しいワークロード

WSL を使用すると、コンピューターの GPU を活用して、機械学習モデルのトレーニングなどのコンピューティング タスクを高速化できます。。 ととも​​に ドライバー 適切かつ WSL 2 を使用すると、パフォーマンスが明らかに向上します。

作業に CUDA、TensorFlow、PyTorch、または OpenCL が含まれる場合は、ドライバーとバージョンの要件を確認してください。ストリームが GPU を集中的に使用する場合は価値があります。

Windows 上の Linux GUI アプリケーション

WSL はグラフィカル Linux アプリケーションをサポートしているため、フロントエンドを使用してエディターやユーティリティを Windows で直接開くことができます。Linux にのみ存在するニッチなツールには便利です。

ウィンドウの統合はシームレスで、Windows 内ではデスクトップ アプリのように動作します。CLI と特定の GUI ユーティリティを組み合わせたフローに役立ちます。

必須コマンドとWindows/Linuxの相互運用性

WSL の大きな利点の 1 つは、両方の世界のコマンドを 1 行に組み合わせることです。。役に立つ例:

  • PowerShellからLinuxでリストする: wsl ls -la
  • LinuxとWindowsの混在: wsl ls -la | findstr "git" o dir | wsl grep git
  • WSLからWindowsツールを開く: notepad.exe .bashrc
  • クロスユーティリティでIPをフィルタリング:
    • Bashの場合: ipconfig.exe | grep IPv4 | cut -d: -f2
    • WSL を使用した PowerShell の場合: ipconfig.exe | wsl grep IPv4 | wsl cut -d: -f2

デフォルトを変更せずにWindowsからディストリビューションを変更するには、次の点を覚えておいてください。 wsl -d <NombreDistro> 時間厳守の配送を開始する埋め込みセッションを終了する場合は、次のように入力します。 exit.

WSLで外付けドライブまたはUSBドライブをマウントする

WSL 2では、外付けドライブ、USB、または Linux パーティションルートを特定したら、次のコマンドでマウントできます。 mount WSL からそのコンテンツを操作します。

環境を離れずにデータのコピー、ディスクの分析、開発メディアの再利用を行うのに便利です。詰まりを防ぐため、作業が終わったら取り外してください。

ディストリビューションを開いて切り替える方法

ディストリビューションはスタートメニューから起動できます（例えば「Ubuntu」と入力）、PowerShell/CMDから名前を入力するか、 wsl.exe デフォルトを開く自分にとって最も快適な方法に調整してください。

WSLの状態に関する簡単な情報を得るには、 wsl [comando] Windowsから例えば wsl -l -v ディストリビューションとバージョンを一覧表示するか、 wsl pwd 現在マウントされているルートを確認します。

WSL プレビューとアップデート

新機能が気に入った場合は、Windows Insider (Dev、Beta、または Preview チャネル) に参加して、最新の WSL 機能を受け取ることができます。安定性はチャネルによって異なりますので、ニーズに応じて選択してください。

チャンネルを変更せずにWSLプレビューを試すことができます:

wsl --update --pre-release

各ビルドの変更と要件については、WSL リリース ノートを参照してください。職場環境では、プレビューをテストする前にリスクを評価します。

  Microsoft Teams でよくある同期の問題を解決する方法

ターミナルをカスタマイズする: Zsh、Oh My Zsh、テーマ

より生産性の高いエクスペリエンスを実現するには、オートサジェスト、カラーリング、プロンプトを改善するテーマとプラグインを備えた Zsh と Oh My Zsh をインストールしてください。Ubuntu/Debianの場合:

sudo apt update && sudo apt install -y zsh curl git

Zshをデフォルトのシェルにする:

chsh -s $(which zsh)

Oh My Zshをインストールする (curl 経由):

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

トピックPowerlevel10k:

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

編集して有効化する ~/.zshrc そして確立する:

ZSH_THEME="powerlevel10k/powerlevel10k"

推奨プラグイン: 追加 plugins=(...) de ~/.zshrc:

  • git
  • zsh 自動提案
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
  • zsh 構文の強調表示
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

変更を保存した後 ~/.zshrcターミナルを再起動するか、 source ~/.zshrc 設定を適用するテーマで必要な場合は、フォントと記号を調整します。

WSL 2 上の Node.js (nvm 付き) (複数のバージョン)

複数のバージョンのNode.jsを競合なく操作するには、nvm（Node Version Manager）を使用します。. nvm を次のコマンドでインストールします。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# Cierra y abre la terminal o:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Node.js（LTSまたは特定のバージョン）をインストールしてバージョンを確認する:

nvm install --lts
node -v
npm -v

必要なときにいつでもバージョンをリストして交換できます:

nvm ls
nvm install 22
nvm alias default 22
nvm use 22

nvm を使用すると、バージョンを変更するときにプロジェクトが「壊れる」ことを回避し、各アプリのクリーンな環境を維持できます。VS Code を使用している場合は、ターミナルでアクティブなバージョンと統合されます。

基本的なBashコマンドで自分の位置を把握する

コマンドラインの使用を始めたばかりの場合は、一般的なユーティリティを簡単に確認しておくと時間を節約できます。:

  • pwd: 現在のルートを表示します。
  • ls, ls -a, ls -l: ファイルとオプションを一覧表示します。
  • cd, cd .., cd ~: ディレクトリ間を移動します。
  • mkdir y touch: フォルダーとファイルを作成します。
  • cat: ファイルの内容を表示します。
  • rm: ファイル/フォルダを削除します (注意: ゴミ箱はありません)。
  • history y !número: 前のコマンドを確認して繰り返します。
  • clear: 画面をクリアします。

これらの基本的な概念を理解することで、自信を持って行動し、できるだけ早くプロジェクトに集中できるようになります。日々の練習がこれらのショートカットを固めるのです。

一般的な問題の診断と解決

Si wsl --install これが失敗した場合は、Windowsのアップデート、仮想化が有効になっていること、および「仮想マシンプラットフォーム」をアクティブ化できることを確認してください。従来のシナリオでは、WSL カーネルを手動でインストール/更新します。

ディストリビューションが起動しない、またはハングする場合は、WSLを再起動してみてください。:

wsl --shutdown

システム間の権限やパスに関する問題については、コードの保存場所を確認し、Linuxツールをシステム上で使用しないでください。 /mnt/c パフォーマンスを重視する場合は、干渉する可能性のあるウイルス対策ソフトウェアがないか確認することも役立ちます。

これらすべてを終えることで、WSLのインストールとメンテナンスから、VS Code/Visual Studio、Git、Docker、データベースとの統合、GPUアクセラレーション、グラフィカルアプリ、Zshによる最適化されたターミナルまで、Linuxの魂を備えた強力なWindows開発環境の強固な基盤が整いました。あとは、ご自身のスタックに合わせて詳細を調整し、開発を開始するだけです。