Zenn
🐧

WSL2 環境構築の手順

2024/08/18に公開
Linux
VS Code
Ubuntu
Windows
WSL 2
tech

WSL2 (Windows Subsystem for Linux 2)

WindowsのLinux仮想マシン (Ubuntu)。
VirtualBoxより軽量、起動も高速。

1. WSL2のインストール

2-1. Windows Terminalをインストール

まずは使いやすいターミナルを準備。
Microsoft Storeから、Microsoft公式のWindows Terminal のアプリをインストール。
Win + X のショートカットキーからターミナルを選択で開く。

Windows Terminal

2-2. WSL2のインストール

  1. インストール

    $ wsl --install

    ※デフォルトでUbuntu のLinuxディストリビューションがインストールされる。

  2. PCの再起動
    再起動後、Ubuntuのユーザー名、パスワードを設定

  3. WSL2が起動していることを確認
    $ wsl -l -v

    Ubuntu Running 2

2-3. Ubuntuターミナル設定 (WSL2)

  • Ubuntu (🐧)をWindows Terminalのデフォルトに設定。

    • デフォルトターミナルに設定

      設定 > スタートアップ > 既定のプロファイル > Ubuntu

      Default Terminal

    • プルダウンメニューに追加

      設定 > Ubuntu

      「ドロップダウンからプロファイルを非表示にする」をオフにする。

Ubuntu Terminal

  • Windows Terminal のプルダウンよりUbuntuターミナル開く。
    バージョン確認

    $ lsb_release -a
    Ubuntu 22.04.1 LTS

2-4. ファイル共有

Windowsエクスプローラー内に、WSL2の共有フォルダLinux > Ubuntuが自動で作成される。
ホームディレクトリ: Linux > Ubuntu > home > {User Name}

WSL2 share

2. WSL2 + ツール

2-1. VSCode

  • WindowsにVSCodeをインストール。
  • WSLというVSCodeの拡張をインストール。
  • WSL2環境でVSCode起動
    • VSCodeサイドパネルのRemote ExprorerからWSL2環境でVSCode起動できる。
    • Ubuntu (WSL2)ターミナルから$ code test.pyなどのコマンドで開いた場合も、WSL2環境でVSCodeが起動する。

2-2. GitHub

  • WSL2上でSSHキーの生成

    $ cd ~/.ssh

    $ ssh-keygen -t rsa

    $ cat id_rsa.pub

  • WSL2上で生成した公開鍵をGithubへ登録
    GitHub > Settings > SSH and GPG keys > New SSH Key

  • SSHの確認
    $ ssh -T [git@github.com](mailto:git@github.com)
    Hi {User Name}! You've successfully authenticated, but GitHub does not provide shell access.

3. 備考

3-1. 仮想マシン(VM)との共存

VirtualBoxなどの仮想マシンとの共存では、Hyper-Vを有効化する必要がある。

コントロールパネル > プログラム > Windowsの機能の有効化または無効化
下記の3項目にチェックをつける。

  • Linux 用 Windows サブシステム
  • 仮想マシンプラットフォーム
  • Windows ハイパーバイザー プラットフォーム (Hyper-V)

注意点として、Hyper-Vを有効にすると、システムリソースをより多く消費するため、パフォーマンスが低下することがある。
実際に、Hyper-Vを有効にすると、VirtualBox上でのカメラ映像が重くなった。

Oracle VM VirtualBox での Hyper-V の使用
注記
この機能を使用すると、一部のホスト システムで Oracle VM VirtualBox のパフォーマンスが大幅に低下する可能性があります。
https://docs.oracle.com/en/virtualization/virtualbox/6.0/admin/hyperv-support.html

3-2. Python

WSL2インストール後、デフォルトでPython3環境が使える。(Ubuntu22のとき)

$ python3 -V
Python 3.10.6
$ which python3
/usr/bin/python3

3-3. ベル通知音の無効化

Windows Terminalの設定 (プルダウン)
Ubuntu (ペンギン) > 詳細設定 > ベル通知スタイル
「音によるチャイム」のチェックを外し、設定を保存。

Discussion