WSL2でWindows 10上でUbuntuを動かす + VSCodeでUbuntuを使う


概要

この記事ではWSL2をインストールしてWindows上でUbuntuを動かす方法を解説します。
また、VSCode上でUbuntuを使う方法についても併せて解説します。

対象

  • Windows PCしか持っていないがUbuntuを触ってみたい人
  • cmdに慣れず、bashでの開発を行いたい人 (dirじゃなくてlsのが楽ですよね)
  • Windows上でDockerを使ってみたい(WSL1でも出来るそうですが個人的にはWSL2の方がオススメ)

WSL2のインストール

Powershellを管理者モードで起動し、下記のコマンドを実行してLinux用Windowsサブシステムを有効にします。

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

次に、WSL2の実行に関する要件を確認します。

  • x64 システムの場合:バージョン 1903 以降、ビルド 18362 以上。
  • ARM64 システムの場合:バージョン 2004 以降、ビルド 19041 以上。

Windowsの検索ボックスにwinverと入力することで現在のバージョンを確認することが出来ます。

また、18362より前のビルドはWSL2に対応していないので、Windowsのバージョンを更新する必要があります。
こちらよりWindowsのバージョンを最新のものに更新することが出来ます。

実行の要件を満たしている場合、下記のコマンドをPowershellを管理者モードで開いて実行し、仮想マシンの機能を有効にします。

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart 

上記コマンドの実行が完了したらPCを一度再起動します。

再起動が終わったら、Linuxカーネル更新プログラム パッケージをダウンロード・インストールします。
こちらより最新バージョンをダウンロードします。
パッケージの指示に従えば勝手に色々やってくれます。

最後にPowershellを起動して下記のコマンドを入力してWSLのバージョンを2に指定します。

wsl --set-default-version 2

これでWSL2のインストールは完了です。

Ubuntuのインストール

次にUbuntuのインストールを行います。

Ubuntuのインストールの仕方は何でも良いのですが、特にこだわりが無ければMicrosoft Storeからダウンロードすることをオススメします。

Microsoft Storeを起動し、アプリ右上の検索バーにubuntuと入力すると画像のようにUbuntuの一覧が表示されます。
今回はUbuntu 18.04 LTSをインストールします。

Ubuntuのインストールが終わりましたら、Windowsの検索ボックスにubuntuと入力し該当のUbuntuを起動します。

Ubuntuを起動すると初回時のみ下記のようなメッセージが表示されるので、該当部分を入力します。
ちなみにパスワードはCUI上に表示されません。

Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: <ユーザー名>
Enter new UNIX password: <パスワード>
Retype new UNIX password: <パスワード再入力>



ユーザー名とパスワードを入力すると下記のようにユーザーが作成されます。
今回はユーザー名をmaruに指定したので、maruと表示されています。

Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: maru
Enter new UNIX password:
Retype new UNIX password:
passwd: password updated successfully
Installation successful!
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

maru@DESKTOP-0H4IUSI:~$

これでWindows上でUbuntuを使うことが出来る状態となりました。

VSCodeでUbuntuを使う

最後にVSCodeでUbuntuを使用する方法を解説します。

VSCodeを起動し、Extentions(Ctrl + Shift + X)を押してwslと検索します。
すると画像のようにRemote - WSLという拡張機能が表示されるのでこちらをインストールします。

インストールが完了するとVSCode左下に緑色のアイコンが表示されます。
こちらのアイコンをクリックしてRemote-WSL: New Windowを選択することでVSCode上でUbuntuを使用することが出来ます。

新しくVSCodeのウィンドウが立ち上がるのでCtrl + Shift + @を押すと下記のようなコマンドが表示されます。

To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

maru@DESKTOP-0H4IUSI:~$ 

以上でVSCodeとUbuntuの連携が完了となります!お疲れ様でした!

最後に

3台のPCで上記のセットアップを行ったのですが、1台のPCでWSL2をインストールが正常に完了しないケースが見られました。(1時間経っても終わらずPCがフリーズする)

WSL1でUbuntuを運用しているPCだったのですが、一度UbuntuをアンインストールしてWSL2のインストール後に再度Ubuntuをインストールし直した際にはスムーズにインストール出来ました。

もしWSL2のインストールに長時間かかってしまう場合にはお試し下さい。
(こちらは動作を保証するものでは無いので自己責任で行って下さい。)