開発環境ガイド

準備

WSL(Ubuntu)をインストールする

Windowsの中にLinux(Ubuntu)の作業場を用意します。

最初に、WSLとUbuntuをインストールします。作業は、管理者として実行したPowerShellで行います。

手順1: PowerShellを管理者として開く

  1. スタートメニューで「PowerShell」と入力します。
  2. 「Windows PowerShell」を右クリックし、「管理者として実行」を選びます。
  3. 「このアプリがデバイスに変更を加えることを許可しますか?」と出たら「はい」を押します。

手順2: WSLをインストールする

次のコマンドを実行します。

wsl --install

このコマンドは、WSLに必要なWindowsの機能を有効にし、標準でUbuntuをインストールします。完了まで数分かかることがあります。

wsl --install は、WSLがまだ入っていないパソコン向けのコマンドです。すでにWSLが入っている場合は、使えるLinuxの一覧を表示して選べます。

wsl.exe --list --online
wsl.exe --install -d Ubuntu

手順3: パソコンを再起動する

インストールが終わったら、メッセージに従ってパソコンを再起動します。

手順4: Ubuntuのユーザーを作る

再起動後、Ubuntuの画面が自動で開きます。開かない場合は、スタートメニューで「Ubuntu」を検索して起動します。

初回はファイルの展開に少し時間がかかります。そのあと、ユーザー名とパスワードの入力を求められます。

  1. ユーザー名: 半角英数字の小文字で入力します(例: taro)。Windowsのユーザー名と同じでなくてかまいません。
  2. パスワード: Ubuntuで管理者の操作(sudo)をするときに使います。入力しても画面には何も表示されませんが、正しく入力されています。確認のため、もう一度入力します。

このパスワードは忘れないように控えておいてください。sudo コマンドのたびに必要になります。

ユーザーの作成が終わると、次のような入力行が表示されます。

taro@laptop:~$

これが WSL(Ubuntu)の中 です。

確認する

Windows側のPowerShell(管理者でなくてかまいません)で、次を実行します。

wsl.exe --list --verbose

次のように、VERSION が 2 になっていれば成功です。

  NAME      STATE           VERSION
* Ubuntu    Running         2

VERSION が 1 になっている場合は、wsl.exe --set-version Ubuntu 2 でWSL 2に変更できます。

うまくいかないとき

  • インストールが0.0%のまま止まる: 次のコマンドで、ダウンロードを先に行ってからインストールします。

    wsl --install --web-download -d Ubuntu
  • 仮想化に関するエラーが出る: パソコンのBIOS/UEFIで、仮想化機能が無効になっている可能性があります。「困ったときは」のページを確認してください。

  • Windows 10で wsl --install が使えない: バージョン2004(ビルド19041)以降が必要です。Windows Updateで更新してください。

参考

Esc で閉じます