はじめに

この記事は、同一筆者によるこちらの記事と同内容です。

やりたいこと

何かの開発環境などを構築する際、既存のWSL環境で構築してしても良いが、まっさらな環境から作成していく方が何かと都合が良いことが多い。
用途別に新しいWSL環境を作成し、目的に応じて切り替える。

手順

現在の状況を確認する
環境の名前とインストールするパスを決める
Ubuntu のイメージをダウンロードする
Ubuntu のイメージをインポートする
一般ユーザーの作成
初期設定
おまけ
参考サイト

現在の状況を確認する

コマンドプロンプトで、wsl -l -v を実行することで現在インストールされているディストリビューションを一覧で確認できる。
下記は、 Microsoft Store からインストールした Ubuntu が1つだけある状態。

> wsl -l -v
  NAME      STATE           VERSION
* Ubuntu    Running         2

環境の名前とインストールするパスを決める

ここでは、環境名は dev-env-u2204 、インストール先は下記にする（フォルダを作成しておく）。

%HOMEPATH%\wsl\env\dev-env-u2204

Ubuntu のイメージをダウンロードする

Ubuntu の公式からダウンロードする（目的に合ったバージョンを選ぶ）。

WSL 向けのイメージは *-wsl.rootfs.tar.gz で終わっているものからCPUに合わせて物を選ぶ。x86 系の 64 bit であれば amd64 でOK。これを適当なフォルダにダウンロードする（今回は %HOMEPATH%\Downloads\ ）。

Ubuntu のイメージをインポートする

コマンドプロンプトで下記コマンドを実行する。

> wsl --import dev-env-u2204 %HOMEPATH%\wsl\env\dev-env-u2204 %HOMEPATH%\Downloads\ubuntu-jammy-wsl-amd64-wsl.rootfs.tar.gz --version 2

これは、下記のような内容になっている

> wsl --import <環境名> <インストール先のパス> <ダウンロードしたイメージのパス> --version <WSLのバージョン>

確認。dev-env-u2204 が追加されているのがわかる。（*が付いているのはデフォルト。wsl --set-default <ディストリビューション名>で変更可能。）

> wsl -l -v
  NAME             STATE           VERSION
* Ubuntu           Running         2
  dev-env-u2204    Stopped         2

確認出来たら以下のコマンドで起動する（PowerShell でも可）。

> wsl -d dev-env-u2204

一般ユーザーの作成

作成直後はrootユーザーしか存在しないため、一般ユーザーを作成する。ユーザー名は何でも良いが、ここではwsl-userとする。

下記では、ユーザーの作成・パスワードの設定・sudo（管理者権限）への追加を実施している。

$ useradd -m -s $(which bash) wsl-user
$ passwd wsl-user
$ usermod -G sudo wsl-user

WSL起動時、-uオプションでユーザー指定でログインできる。

> wsl -d dev-env-u2204 -u wsl-user

初期設定

毎回のユーザー指定が面倒なので、デフォルトユーザーを設定する。また、起動時にWindows側のPATH（環境変数）を引き継がないように設定する。
どちらも、/etc/wsl.confを以下のように設定すればOK（※編集には管理者権限が必要）。

[user]
default = wsl-user
[interop]
appendWindowsPath = false

起動時の初期ディレクトリをホームディレクトリにする。

$ echo 'cd ~' >> ~/.bashrc

WindowsのPATHを反映しないようにしたが、ディレクトリをエクスプローラで開くexplorer.exe .などは使いたいので、それは個別に設定する。また、vscodeを用いるため、そのパスも通す。

> where code      <-- vscodeのパス確認

WSL側でパスを通す。vscodeのパスは上記で確認したものに置き換える。

$ echo export PATH=\$PATH:/mnt/c/WINDOWS/ >> ~/.bashrc
$ echo export PATH=\$PATH:\"/mnt/c/Users/[user_name]/AppData/Local/Programs/Microsoft VS Code/bin\" >> ~/.bashrc

これで下記コマンドが使用可能になる。

$ explorer.exe [ディレクトリ]    <---- ディレクトリをWindowsのエクスプローラで開く
$ code [ディレクトリ]    <---- ディレクトリをvscodeで開く

ここまで来たら一旦WSLを再起動する。

> wsl -t dev-env-u2204
> wsl -d dev-env-u2204

あとはパッケージの最新化などをすれば完了。（※オブション-qは詳細を省略しメッセージ量を減らす。-yはYES/NOの回答を省略する）

$ sudo apt update -q && sudo apt upgrade -yq

おまけ

毎度explorer.exe .と入力するのは面倒くさいので、エイリアスを設定する。

$ echo alias ee=\'explorer.exe .\' >> ~/.bashrc
$ source ~/.bashrc    <---- 有効にするためシェルを再読み込み

こうすると、eeと入力するだけでexplorer.exe .が実行される。そのほか、よく使うオプションを省略できるよう設定したりもできるので、エイリアスは覚えておくと少し幸せになる。

★ここまでの設定を毎度実行するのはまあまあめんどくさいので、シェルスクリプトなどを用いて一発で済むようにしておくのがおすすめ。
->（追記）この記事でスクリプト例を公開しました。

まっさらなWSL2環境を新たに作成する