エラーの内容
Microsoft StoreからLinuxディストリビューションを起動しようとしたか、PowerShellでwslと入力したところ、次のエラーが表示された場合:
The Windows Subsystem for Linux optional component is not enabled. Please enable it and try again.
See https://aka.ms/wslinstall for details.
WSLはWindowsのオプション機能であり、デフォルトでは無効になっています。OSレベルでこの機能を有効にするまで、どのディストリビューションも動作せず、wslコマンドも機能しません。
WSLを有効にする3つの方法
お使いのWindowsバージョンと必要なWSLのバージョンに応じて選択してください。WSL 2が現在の標準です。より高速で互換性が高く、Microsoftが新規セットアップに推奨しています。
方法1:コマンド一発でインストール(WSL 2に推奨)
Windows 10 バージョン2004(ビルド19041)以降、およびWindows 11のすべてのバージョンでは、すべてを一括処理する単一のコマンドが利用できます:
wsl --install
PowerShellを管理者として開き、このコマンドを実行してください。このコマンドは内部で以下を実行します:
- WSLオプション機能を有効化
- 仮想マシンプラットフォームを有効化
- WSL 2のLinuxカーネルをダウンロードしてインストール
- デフォルトのディストリビューションとしてUbuntuをインストール
完了したら、PCを再起動してください。再起動するまでWSLは動作しません。例外はありません。
Ubuntuが不要な場合は、別のディストリビューションを指定できます:
wsl --install -d Debian
wsl --install -d kali-linux
wsl --install -d openSUSE-42
利用可能なディストリビューションの一覧を確認するには:
wsl --list --online
方法2:機能を手動で有効化(古いWindows 10またはWSL 1の場合)
ビルド19041より古いバージョンを使用している場合、またはWSL 1が必要な場合は、手動で設定します。
手順1 — WSLを有効化:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
手順2 — 仮想マシンプラットフォームを有効化(WSL 2に必要):
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
手順3 — PCを再起動します。
**手順4 — WSL 2カーネルアップデートをインストール:**Windows 10ユーザーはこの追加手順が必要です。Microsoftの公式ページからカーネルアップデートパッケージをダウンロードして実行してください。Windows 11はカーネルが標準搭載されているため、この手順は不要です。
手順5 — WSL 2をデフォルトバージョンに設定:
wsl --set-default-version 2
手順6 — ディストリビューションをインストール(Microsoft StoreでUbuntu、Debianなどを検索)またはコマンドラインから:
wsl --install -d Ubuntu
方法3:Windowsの機能GUIを使う
GUIで操作したい場合も問題ありません。
Win + Rを押し、optionalfeaturesと入力してEnterを押す- スクロールしてWindows Subsystem for Linuxにチェックを入れる
- WSL 2を使う場合は仮想マシンプラットフォームにもチェックを入れる
- OKをクリックし、求められたら再起動する
修正の確認
再起動が完了したら、PowerShellを開いてステータスを確認します:
wsl --status
正常な出力は次のようになります:
Default Version: 2
The Windows Subsystem for Linux kernel can be manually updated with 'wsl --update'.
インストール済みのディストリビューションと使用しているWSLバージョンを確認します:
wsl --list --verbose
NAME STATE VERSION
* Ubuntu Stopped 2
wslを実行して起動します。Linuxのシェルプロンプトが表示されれば完了です。
有効化後によくある問題
「WslRegisterDistribution failed with error: 0x80370102」
BIOS/UEFIで仮想化が無効になっています。再起動してBIOS設定画面に入り(起動時に通常DelまたはF2)、Intel VT-xまたはAMD-V(SVMモードと表示される場合もあります)を有効にしてください。メニューの場所はマザーボードによって異なります。見つからない場合はボードのマニュアルを確認してください。
WSL 2をデフォルトに設定する際「Error: 0x1bc」が表示される
お使いのWindowsビルドがWSL 2に対応していません。Windows Updateを実行して少なくともバージョン2004(ビルド19041)に更新してください。今すぐ更新できない場合は、WSL 1にフォールバックします:
wsl --set-default-version 1
wsl --installコマンドが認識されない
ビルド19041より古いWindows 10を使用しています。方法1は使用できません。代わりに方法2のdism.exeの手順を使用してください。
クイックリファレンス
- WSLステータスの確認:
wsl --status - インストール済みディストリビューションの一覧:
wsl --list --verbose - WSLカーネルの更新:
wsl --update - すべてのWSLインスタンスをシャットダウン:
wsl --shutdown - ディストリビューションの削除:
wsl --unregister Ubuntu

