第0章: WSL2セットアップ
前提(検証環境)
- Windows 10 Version 2004 以降 / Windows 11
- PowerShell を管理者権限で実行できること(企業 PC などで制限される場合がある)
- 本書は WSL2 上の Ubuntu を想定(インターネット接続が必要な手順を含む)
この章の目標
- WSL2 をインストールし、Ubuntu を起動できる
- Ubuntu 上で基本的な Linux コマンドを実行できる
できるようになること
- Windows 上で Linux を利用できる環境を構築できる
- ターミナルからコマンドを実行できる
0.1 必要な環境
Windows 要件の確認
# PowerShellで実行
winver
必要なバージョン:
- Windows 10 Version 2004 以降
- Windows 11(全バージョン)
※企業 PC などで管理者権限がない場合や、組織のポリシーにより WSL2 のインストールが制限されている場合があります。その場合は、システム管理者または情報システム部門に確認してください。
0.2 WSL2 のインストール(3 ステップ)
ステップ1: PowerShell を管理者権限で開く
- スタートボタンを右クリック
- 「Windows PowerShell(管理者)」をクリック
ステップ2: WSL2 をインストール
# 1 行で実行
wsl --install
このコマンドでインストールされるものは次のとおりです。
- WSL2本体
- Ubuntu(Linux)
- 必要な機能一式
ステップ3: PCを再起動
インストール完了後、PCを再起動します。
0.3 初回セットアップ
Ubuntuの起動
再起動後、スタートメニューから「Ubuntu」を起動します。
初回起動時の設定は次のとおりです。
# ユーザー名を入力(英小文字と数字)
Enter new UNIX username: myname
# パスワードを設定(入力時は表示されません)
New password:
Retype new password:
注意: パスワードは入力しても画面に表示されません(正常な動作です)。
動作確認
# Ubuntuのバージョン確認
lsb_release -a
# 現在のユーザー名確認
whoami
# 現在の場所確認
pwd
0.4 Windows Terminalの設定(オプション)
必要に応じて Windows Terminal を導入します。
# PowerShellで実行
winget install Microsoft.WindowsTerminal
Windows Terminalの利点は次のとおりです。
- タブで複数のターミナルを開ける
- 見やすいフォントと色
- コピー/ペーストが容易
0.5 トラブルシューティング
よくある問題と解決法
エラー: 「WSL 2 requires an update to its kernel component」
# カーネルアップデートをダウンロードし、手動でインストール
# 参照: https://aka.ms/wsl2kernel
エラー: 「Virtual Machine Platform」が無効
# 管理者権限のPowerShellで実行
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# その後、PC再起動
Ubuntu が起動しない
# 初期対応
wsl --shutdown
wsl --status
wsl --update
# (必要なら)バックアップ
# wsl --export Ubuntu ubuntu-backup.tar
# 注意: --unregister は対象ディストリビューションのデータを削除します(復旧不可)
# 最終手段(データ削除を許容できる場合のみ実施)
wsl --unregister Ubuntu
wsl --install -d Ubuntu
セットアップ完了
WSL2 環境の準備が完了しました。次章以降は、実際にコマンドを実行しながら進めます。
確認コマンド
# すべて正常に動作するか確認
echo "Hello, Linux!"
date
ls -la
まとめ
- WSL2 のインストールと Ubuntu の初回セットアップが完了した
- Ubuntu ターミナルで基本コマンドが実行できる状態になった
- 以降の章は「実際にコマンドを打つ」ことを前提に進められる
次章へ: 第1章 Linuxの世界への第一歩