「ターミナルでvimを使えと言われても、操作が難しすぎる。」
WSL2でLinuxを動かせるようになったら、次の壁はエディタです。
Linuxのターミナル上でvimやnanoを使う方法もありますが、初心者にはハードルが高めです。
そこで使いたいのが、VS CodeのRemote WSL拡張機能です。
これを使えば、WindowsのVS Codeから直接WSL2のLinux上にあるファイルを開いて編集できます。WSL2のターミナルで「
code .」と入力するだけで起動するので、設定も最小限で済みます。この記事では、Remote WSL拡張のインストールから実際の使い方、Git連携(GitHubへのSSH鍵設定を含む)、PythonなどのWSL2側への拡張機能インストール、ポート転送によるローカルサーバーの確認、GitHub Copilotとの組み合わせ、よくあるエラーの対処まで、初心者向けにゼロから解説します。
※動作確認環境: Windows 11 / WSL2(Ubuntu 24.04 LTS)/ VS Code 1.99
この記事のポイント
・「code .」コマンドでWSL2のLinuxファイルをVS Codeで即座に開ける
・Remote Development拡張のインストールは5分もかからない
・Python・Git・ESLintなどの拡張機能はWSL2側にもインストールが必要
・プロジェクトは/home以下に置くと/mnt/cより動作が高速になる
・WSL2でWebサーバーを起動するとVS Codeが自動でポート転送を提案する
・GitHub CopilotはWSL2接続中も動作し、AIの補完を受けながらLinux開発ができる
・VPSやクラウドのサーバーを編集したい場合はRemote SSH拡張を使う(本記事はWSL2向け)
・「code: command not found」は再インストールで解決するケースがほとんど
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
VS CodeのRemote WSL機能とは何か
VS Codeには「リモート」系の拡張機能が複数あるため、最初に整理しておきます。| 拡張機能 | 接続先 | こんな人向け |
|---|---|---|
| Remote - WSL(今回の記事) | 同じPCのWSL2 Linux | Windowsで手軽にLinux環境を使いたい人 |
| Remote - SSH | VPS・クラウドなどSSH接続できるサーバー | VPSや自宅サーバーのファイルを編集したい人 |
| Dev Containers | Dockerコンテナの中 | チームで同じ環境を再現したい人 |
通常はWindowsのファイルを編集しますが、「Remote WSL」という拡張機能を追加すると、WSL2のLinux環境に直接接続してLinux上のファイルを編集できます。
仕組みとしては、VS Codeの見た目(UI部分)はWindowsで動きながら、裏側でWSL2のLinux上に「VS Code Server」という小さなサーバーを起動しています。
WindowsのVS CodeとLinux上のVS Code Serverがつながることで、あたかもLinux上でVS Codeが動いているかのように使えます。
この方式のメリットを整理すると、こうなります。
・ファイルパスがLinuxネイティブ:/home/user/project のようなLinuxのパスでそのまま作業できる
・ターミナルもLinux:VS Code内蔵ターミナルを開くとWSL2のbashが自動で起動する
・拡張機能もLinux側で動く:PythonやNode.jsの拡張機能がWSL2のインタープリタを正しく認識する
・ファイルアクセスが高速:プロジェクトをWSL2のファイルシステム(/home/以下)に置くと、Windowsの/mnt/c経由より大幅に速くなる
「VPSで作業したい」場合はRemote SSHを使う
Remote WSLは「同じPC内のWSL2」に接続するための拡張機能です。ConoHaやAWSなどのVPS・クラウドサーバーに接続したい場合は「Remote - SSH」を使います。Remote SSHを使うとWindowsのVS CodeからVPSのファイルをGUI操作で直接編集でき、Ctrl+Sで保存するとVPS上のファイルが即座に更新されます。公開鍵認証(SSH鍵ペア)が設定済みであれば、コマンドパレットから数クリックで接続できます。接続先が複数ある場合は
~/.ssh/config に接続先ホストを登録しておくと、名前(エイリアス)で呼び出せます。Remote WSL(ローカルWSL2)とRemote SSH(リモートVPS)の使い分けを一言でまとめると次のとおりです。
| 比較項目 | Remote WSL | Remote SSH |
|---|---|---|
| 接続先 | 同じPCのWSL2環境 | VPS・クラウド・物理サーバー |
| ネットワーク | ローカルの内部接続(インターネット不要) | インターネット経由のSSH接続 |
| SSH鍵 | 不要 | 公開鍵認証を推奨 |
| 主な用途 | ローカルLinux開発・学習 | 本番サーバー・クラウドの作業 |
| 接続開始 | WSL2ターミナルで code . を実行 |
コマンドパレットから「Connect to Host」 |
「チームで全員が同じ環境を使いたい」場合はDev Containersを検討する
Remote WSLは「自分のPC上のWSL2に直接接続する」シンプルな方式です。一人で開発するうちは十分ですが、「npm installしたら自分のPCでは動いたのにチームメンバーのPCではエラーになった」という問題が出てきたら、Dev Containersへのステップアップを検討するタイミングです。Dev Containersは
devcontainer.json という設定ファイル1つで、チーム全員が全く同じDockerコンテナ環境を再現できる仕組みです。まずはRemote WSLで慣れてから、必要に応じてDev Containersに移行するのがおすすめの流れです。VS Code Remote WSLとWSL2の組み合わせでできること(まとめ)
| 項目 | Remote WSL接続なし | Remote WSL接続あり |
|---|---|---|
| ファイルの編集場所 | Windowsのファイルシステム | WSL2(Linux)のファイルシステム |
| 内蔵ターミナル | WindowsのPowerShell / cmd | WSL2のbash(Linuxコマンドが使える) |
| Python拡張機能 | WindowsのPythonを参照 | WSL2(Linux)のPythonを参照 |
| Gitコマンド | WindowsのGitを使用 | WSL2のgitを直接使用 |
インストールの準備と確認
1. WSL2が動いているか確認する
まずWSL2が正常に動いているか確認します。Windowsのコマンドプロンプトまたはターミナルで以下を実行してください。
# Windows側のコマンドプロンプトで実行する > wsl --list --verbose NAME STATE VERSION * Ubuntu-24.04 Running 2
「Stopped」と表示された場合は、スタートメニューから「Ubuntu」を起動してください。
「1」と表示された場合はWSL1として動作しているため、以下のコマンドでWSL2に変換できます。
# Ubuntu-24.04をWSL2に変換する(ディストリビューション名は環境に合わせる) > wsl --set-version Ubuntu-24.04 2
2. VS Codeをインストールする
VS CodeはMicrosoftの公式サイト(https://code.visualstudio.com/)からダウンロードしてインストールします。インストーラーを実行するときに、「PATHへの追加」オプションにチェックが入っていることを確認してください。
このチェックが外れていると、ターミナルから「
code」コマンドを実行できません。インストール済みの場合はWindowsのコマンドプロンプトでバージョンを確認できます。
# Windowsのコマンドプロンプトで実行する > code --version 1.99.3 b8a78f6b27a244b965fcedca9e25be12f74f1700 x64
3. Remote Development拡張をインストールする
VS Codeを起動して、左サイドバーの「拡張機能」アイコン(Ctrl+Shift+X)をクリックします。検索ボックスに「Remote Development」と入力して、Microsoftが提供する同名の拡張機能をインストールします。
このパックには以下の3つの拡張が含まれています。
・Remote - WSL(今回使う拡張機能。拡張機能ID: ms-vscode-remote.remote-wsl):WSL2のLinux環境に接続する
・Remote - SSH(拡張機能ID: ms-vscode-remote.remote-ssh):SSH経由でリモートサーバーに接続する
・Dev Containers:Dockerコンテナの中で開発する
3つがまとめてインストールされますが、今回使うのは「Remote - WSL」のみです。
インストール完了後、VS Codeの左下に青い「><」アイコンが表示されます。このアイコンをクリックするとWSL2への接続メニューが開きます。
インストールが完了したか確認したい場合は、Windowsのコマンドプロンプトで以下のコマンドを実行します。
# インストール済みのRemote系拡張を確認する(Windowsのコマンドプロンプトで実行) > code --list-extensions | findstr remote ms-vscode-remote.remote-containers ms-vscode-remote.remote-ssh ms-vscode-remote.remote-ssh-edit ms-vscode-remote.remote-wsl
WSL2のファイルをVS Codeで開く基本操作
1. WSL2のターミナルから「code .」を実行する
WSL2のUbuntuターミナルを開いて、作業したいディレクトリに移動してから「code .」を実行します。# ホームディレクトリに練習用フォルダを作成して移動する $ mkdir ~/myproject && cd ~/myproject # VS Codeを開く(「.」は現在のディレクトリを意味する) $ code .
# 特定ファイルだけVS Codeで開く場合 $ code ~/myproject/hello.sh
2. VS Code Serverのインストールと接続確認
初回は「code .」を実行すると、WSL2の中にVS Code Serverが自動でインストールされます。$ code . Installing VS Code Server for Linux x64 (b8a78f6b27a244b965fcedca9e25be12f74f1700) Downloading: 100% Unpacking: 100% Starting VS Code Server... Extension host agent listening on 47125.
左下の緑色のエリアに「WSL: Ubuntu-24.04」と表示されていれば、WSL2に正常に接続できています。
2回目以降は「code .」を実行するとほぼ即座にVS Codeが開きます。
接続後にVS Codeの統合ターミナルを開いて、Linuxディストリビューションを確認することもできます。
# 接続後のVS Code統合ターミナルで実行する(出力例) $ cat /etc/os-release NAME="Ubuntu" VERSION="24.04.1 LTS (Noble Numbat)" ID=ubuntu
3. ファイルを作成して動作確認する
VS Codeのエクスプローラー(左サイドバー)に「myproject」フォルダが表示されています。「新しいファイル」ボタンで「hello.sh」を作成し、以下の内容を入力してみましょう。
#!/bin/bash echo "WSL2でVS Codeが使えています"
# 実行権限を設定して実行する $ chmod +x hello.sh $ ./hello.sh WSL2でVS Codeが使えています
4. ワークスペースの保存とプロジェクトの再接続
VS Codeのワークスペース情報は「ファイル」→「名前を付けてワークスペースを保存」で .code-workspace ファイルとして保存できます。次回以降は保存した .code-workspace ファイルをダブルクリックするだけで、WSL2接続済みの状態でプロジェクトが開きます。
また、最近開いたフォルダはVS Codeの「ファイル」→「最近使用したファイルを開く」(Ctrl+R)から素早く再アクセスできます。
WSL2接続のフォルダには「[WSL: Ubuntu-24.04]」のラベルが付いているので、Windowsのフォルダと区別できます。
知っておきたい実践Tips
1. 拡張機能はWSL2側にもインストールする
VS Codeの拡張機能には「Windows側で動くもの」と「WSL2(Linux)側で動くもの」の2種類があります。Pythonの補完機能やESLintなど、コードに直接関係する拡張機能はWSL2側にインストールする必要があります。
拡張機能の詳細ページを開くと、インストールボタンの横に「WSL: Ubuntu-24.04にインストール」と表示されることがあります。
その場合はそのボタンからWSL2側へインストールしてください。
WSL2側にインストール済みかどうかは、左サイドバーの「拡張機能」を開いて「インストール済みのWSL: Ubuntu-24.04用」セクションで確認できます。
現場でよく使われる拡張機能の参考例は次のとおりです。
・Python:Pythonスクリプトのシンタックスハイライト・補完・デバッグ
・ShellCheck:シェルスクリプトの構文エラーを静的解析で検出
・YAML:Docker ComposeやAnsibleのPlaybookなど設定ファイルの補完と整形
・ESLint:JavaScriptのコードスタイルチェックとエラー検出
2. VS Code内蔵ターミナルでLinuxコマンドを実行する
WSL2接続中にVS Codeのターミナル(Ctrl+`)を開くと、自動でWSL2のbashが起動します。LinuxコマンドをVS Codeの画面を離れずに実行できるので、エディタとターミナルを行き来する手間が省けます。
# VS Code内蔵ターミナル(WSL2のbash)での確認例(出力例) tomohiro@DESKTOP-XXXXX:~/myproject$ uname -a Linux DESKTOP-XXXXX 5.15.167.4-microsoft-standard-WSL2 #1 SMP Tue Nov 5 00:21:55 UTC 2024 x86_64 GNU/Linux tomohiro@DESKTOP-XXXXX:~/myproject$ ls -la total 8 drwxr-xr-x 2 tomohiro tomohiro 4096 Jul 14 09:00 . drwxr-xr-x 8 tomohiro tomohiro 4096 Jul 14 08:55 .. -rwxr-xr-x 1 tomohiro tomohiro 56 Jul 14 09:00 hello.sh
3. 別のプロジェクトを開くときはcode .を使い回す
WSL2上の別のフォルダを開きたいときは、WSL2のターミナルでそのフォルダに移動してから「code .」を実行するのが最もシンプルです。# 別のプロジェクトに移動してVS Codeで開く $ cd ~/anotherproject $ code .
既存のウィンドウと並べて使いたい場合は「ファイル」→「新しいウィンドウでフォルダーを開く」を使ってください。
4. Git連携はWSL2側のgitが自動で使われる
WSL2接続中のVS CodeでGitを使うと、VS Code内蔵のソース管理パネル(Ctrl+Shift+G)がWSL2のgitコマンドを直接呼び出します。Windows側にGitをインストールしていなくても、WSL2にgitさえ入っていれば問題ありません。
# WSL2にgitをインストールする(未インストールの場合) $ sudo apt update && sudo apt install -y git # gitの動作確認 $ git --version git version 2.43.0
ターミナルでgitコマンドを直接打つのが苦手な方には、特におすすめの使い方です。
GitHubへのSSH接続設定(リモートリポジトリへのpushに必要)
GitHubにSSH経由でpushする場合は、WSL2のLinux内でSSH鍵ペアを生成してGitHubに登録する必要があります。Windows側の鍵とは別に、WSL2専用の鍵を用意するのが管理しやすくなります。
# WSL2のターミナルでSSH鍵ペアを生成する $ ssh-keygen -t ed25519 -C "メモ用の文字列(例: github-wsl2)" # 3回Enterを押すとデフォルト設定で鍵が作成される # 秘密鍵: ~/.ssh/id_ed25519 # 公開鍵: ~/.ssh/id_ed25519.pub # 公開鍵の内容を表示する(この内容をGitHubに登録する) $ cat ~/.ssh/id_ed25519.pub ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... github-wsl2
登録後、WSL2のターミナルで `ssh -T git@github.com` を実行して接続を確認し、その後 `git push` を実行するとSSH経由でGitHubにプッシュできます。
5. Python(conda/venv)仮想環境をVS Codeで切り替える
WSL2でPythonの仮想環境(condaやvenv)を使っている場合、VS CodeのPython拡張機能がその仮想環境を自動で検出します。VS Codeウィンドウ右下のPythonバージョン表示をクリックするか、コマンドパレット(Ctrl+Shift+P)で「Python: インタープリターを選択」を実行すると、仮想環境を切り替えられます。
# WSL2でconda仮想環境を作成する(Minicondaインストール済みの場合) $ conda create -n myenv python=3.11 $ conda activate myenv # VS CodeのPython拡張機能(WSL2側にインストール済みの場合) # 右下のPythonバージョン表示をクリックすると「myenv」が選択肢に表示される
複数プロジェクトでPythonバージョンや依存パッケージを分けて管理したい場合に役立ちます。
6. プロジェクトはWSL2の/home以下に置く
WSL2でよくある落とし穴として、プロジェクトを「/mnt/c/Users/自分の名前/」のようなWindowsのファイルシステム上に置いてしまうケースがあります。この場合、ファイルアクセスがWindows↔Linux間の変換レイヤー(Plan 9 Filesystem Protocol)を経由するため、大量のファイルを扱うNode.jsやPythonのプロジェクトで動作が極端に遅くなることがあります。
「npm installが異常に遅い」「pytest実行に時間がかかる」という問題の多くは、プロジェクトを/mnt/c以下に置いていることが原因です。
対策はシンプルで、プロジェクトをWSL2のホームディレクトリ(/home/ユーザー名/)以下に置くだけです。
# 現在の作業場所を確認する(/mnt/cではなく/home以下であることを確認) $ pwd /home/tomohiro/myproject # もし/mnt/c以下にあるなら/homeにコピーして移行する $ cp -r /mnt/c/Users/tomohiro/myproject ~/myproject $ cd ~/myproject $ code .
Gitリポジトリも/home以下にcloneするのが運用上の定石です。
※注意:WSL2をアンインストールまたはリセットすると、/home以下のファイルも削除されます。大切なプロジェクトはGitHubやリモートリポジトリにバックアップしておくことを忘れずに。
7. WindowsエクスプローラーでWSL2のファイルをブラウズする
VS Codeを使わずにWindowsエクスプローラーでWSL2内のファイルを確認したい場合は、エクスプローラーのアドレスバーに以下のパスを入力してください。# WindowsエクスプローラーのアドレスバーにUNCパスを入力する \\wsl$\Ubuntu-24.04\home\tomohiro
ただし、エクスプローラー経由でのファイル操作はパフォーマンスが下がることがあるため、日常的な編集作業はVS CodeのRemote WSL経由で行うほうが快適です。
8. Dev ContainersとRemote WSLの使い分けを知る
Remote WSLは「自分のPC1台で気軽にLinux開発を始める」には最適な方法です。一方、プロジェクトの規模が大きくなったり、複数の言語バージョンを切り替えたりする場面が増えてくると、Dev Containersへのステップアップを検討するタイミングが来ます。以下の表を参考に、どちらを使うか判断してください。
| 状況 | Remote WSL | Dev Containers |
|---|---|---|
| 一人でWSL2を使って開発する | 最適 | オーバースペック気味 |
| チームで同じ環境を再現したい | 環境差異が出やすい | 設定ファイル1つで全員が同じ環境 |
| プロジェクトごとに言語バージョンを分けたい | conda/nvm等の切替ツールが必要 | コンテナを切り替えるだけ |
| 本番Linux環境との差異を最小化したい | WSL2のUbuntuが基盤 | 本番と同じDockerイメージを使える |
| Dockerの知識がない・まずVS Codeに慣れたい | 追加知識不要で始められる | Docker基礎知識が必要 |
9. GitHub CopilotをWSL2接続中に使う
VS CodeのRemote WSL接続中でも、GitHub Copilot拡張機能を追加することでAIによるコード補完が使えます。CopilotはWSL2側の言語環境(PythonのインタープリタやNode.jsのバージョン)を正しく認識した上で補完を提案するので、ローカルのWindows環境で使うよりも精度が高くなるケースがあります。インストール後、WSL2接続中に拡張機能パネルを開くと「WSL: Ubuntu-24.04にインストール」のボタンが表示される場合があります。その場合はWSL2側へも追加でインストールしてください。
実際の活用場面としては、こういった使い方が効果的です。
・シェルスクリプトを書くとき、コメントで処理の意図を書くとCopilotがコマンドを補完してくれる
・Pythonコードのエラーをコメントとして貼り付けると、Copilotが修正案を提案することがある
・見慣れないLinuxコマンドのオプションや使い方をCopilot Chatに質問しながら手を動かすと習得が早い
・コマンドの実行結果をCopilot Chatに貼り付けて「このエラーの意味は何ですか」と質問すると、原因の見当がつきやすい
「コマンドは分かるけどスクリプト化が苦手」という段階から、AIとペアで作業することでLinuxスキルの習得速度が上がります。
10. WSL2のWebサーバーをWindowsブラウザで確認する(ポート転送)
WSL2でNode.jsやPythonのWebサーバーを起動すると、VS Codeが「ポートをローカルホストに転送しますか?」という通知を自動で表示します。通知に従って転送を許可すると、WindowsのChromeやEdgeから直接WSL2上の開発サーバーにアクセスできます。
# WSL2のターミナルでPythonの簡易Webサーバーを起動する(出力例) $ python3 -m http.server 8000 Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...
http://localhost:8000 と入力するとWSL2のサーバーに接続できます。転送中のポートはVS Codeのターミナルパネル横にある「ポート」タブで一覧確認できます。手動でポートを追加・削除したい場合や、転送の公開範囲(ローカルのみ・パブリック)を変更したい場合もこのタブから操作できます。
VS Codeが自動でポートを検出しない場合は、「ポート」タブを開いて「ポートの転送」ボタン(+アイコン)をクリックし、転送したいポート番号を直接入力することもできます。Node.jsの開発サーバー(
npm run dev)はポート3000や5173を使うことが多く、Flaskはデフォルトで5000番を使います。# Node.jsの開発サーバー起動例(出力例) $ npm run dev VITE v5.0.0 ready in 200 ms ➜ Local: http://localhost:5173/ # → WindowsのブラウザでURL欄に http://localhost:5173 を入力してアクセスできる # Flaskの開発サーバー起動例(出力例) $ flask run * Running on http://127.0.0.1:5000 # → WindowsのブラウザでURL欄に http://localhost:5000 を入力してアクセスできる
npm run dev を使うプロジェクトや、Flaskなどで python3 app.py を実行するプロジェクトも同様に自動で転送されます。WSL2の開発環境でWebアプリを開発するときに便利な機能です。11. VPSのファイルを編集したい場合はRemote SSH拡張を使う
WSL2でのローカル開発に慣れてきたら、次のステップとしてVPS(ConoHa・さくらVPS・AWSのEC2など)での実サーバー運用に挑戦することがあります。VPS上のファイルをVS Codeで直接編集したい場合は、Remote WSLではなく「Remote - SSH」拡張機能を使います。Remote SSHの基本的な使い方は次のとおりです。
・VS CodeのコマンドパレットでRemote-SSH: Add New SSH Hostを実行し、
ssh ubuntu@VPSのIPアドレス の形式で接続先を登録する・登録後、「Remote-SSH: Connect to Host」でVPSを選択するとVPS上にVS Code Serverが自動インストールされ接続される
・接続後はローカルのWSL2と同様に、サイドバーでVPSのファイルをツリー表示・編集できる
VPSを複数管理している場合は、Windowsの
C:\Users\ユーザー名\.ssh\config(SSH設定ファイル)にホスト情報をまとめておくと便利です。# C:\Users\ユーザー名\.ssh\config の設定例(複数サーバーの登録) Host webserver HostName 203.0.113.10 User ubuntu IdentityFile ~/.ssh/id_ed25519 Host devserver HostName 198.51.100.20 User centos IdentityFile ~/.ssh/id_ed25519
※注意:VPSでRemote SSHを使うには、VPS側でSSH公開鍵認証が設定済みであることが前提です。ファイアウォールのルールを変更する際はSSHポート(デフォルトTCP 22番)の許可ルールを先に確認してから作業してください。SSH接続が切れた状態でSSHポートを閉じると、コンソール接続以外でVPSにアクセスできなくなるトラブルが起きやすいためです。
「code: command not found」が出た時の対処法
WSL2のターミナルで「code .」を実行したときに、次のエラーが出ることがあります。$ code . -bash: code: command not found
・確認1 VS CodeのPATHが通っているか:WSL2のターミナルで以下を実行する
# VS CodeのPATHがWSL2に引き継がれているか確認する $ echo $PATH | tr ':' '\n' | grep -i vscode /mnt/c/Users/YourName/AppData/Local/Programs/Microsoft VS Code/bin
・確認2 VS Codeをインストールし直す:VS Codeをアンインストールして公式サイトからインストーラーを再ダウンロードし、「PATHへの追加」にチェックを入れてインストールする
・確認3 WSL2を再起動する:VS Code再インストール後は、WSL2を一度シャットダウンして起動し直す
# Windows側のコマンドプロンプトで実行する > wsl --shutdown # 再度WSL2を起動する > wsl
・確認4 /etc/wsl.confの設定を確認する:WSL2のターミナルで以下を実行する
# /etc/wsl.confの内容を確認する(ファイルが存在する場合のみ) $ cat /etc/wsl.conf [interop] appendWindowsPath = false
[interop] セクションに appendWindowsPath = false や enabled = false が設定されている場合、WindowsのPATHがWSL2に引き継がれず、VS CodeのPATHも通りません。該当の行を削除またはコメントアウトしてからWSL2を再起動してください。
・確認5 Permission deniedでファイルが保存できない:WSL2内で
/etc/ 配下のシステムファイルをVS Codeから直接保存しようとすると Permission denied になります。root権限が必要なファイルの場合は、ターミナルで sudo を使う方法が確実です。# 権限を確認する $ ls -la /etc/hosts -rw-r--r-- 1 root root 224 Jul 14 09:00 /etc/hosts # 一時ファイルに保存してからsudoで配置する方法 # 1) VS Codeでホームディレクトリ配下の ~/hosts.tmp を新規作成して編集・保存 # 2) ターミナルでsudoを使って配置する $ sudo cp /etc/hosts /etc/hosts.bak.$(date +%Y%m%d) $ sudo mv ~/hosts.tmp /etc/hosts
・確認6 Remote WSL拡張機能のバージョンが古い:VS Codeのバージョンと拡張機能のバージョンに大きなズレがある場合、接続後すぐに切断されたり「WSL: Ubuntu-24.04」への接続が途中で止まったりすることがあります。左サイドバーの「拡張機能」を開き、「ms-vscode-remote.remote-wsl」を探して更新ボタンが表示されていればアップデートしてから再接続してください。
・確認7 Windows Terminalを使っているか確認する:Windows 11標準のWindows Terminalから「Ubuntu」タブを開いた場合と、スタートメニューの「Ubuntu」から直接起動した場合では、ターミナルの環境変数の引き継ぎ方が異なることがあります。「code .」が通らない場合は、別の方法でWSL2を開いて再試行してみてください。
本記事のまとめ
WSL2とVS Codeを組み合わせることで、WindowsユーザーでもLinuxの開発環境を快適に使えるようになります。「WSL2は動かせるようになったけどいまいち使い方が分からない」という方は、今日からVS Codeと一緒に活用してみてください。
| やりたいこと | 操作方法 |
|---|---|
| WSL2のフォルダをVS Codeで開く | WSL2ターミナルで code . を実行 |
| 特定のファイルをVS Codeで開く | WSL2ターミナルで code ファイル名 を実行 |
| VS Codeのターミナルをbashとして使う | Ctrl+` でターミナルを開く(WSL2接続中は自動でbashになる) |
| 拡張機能をWSL2側にインストールする | 拡張機能の詳細ページで「WSL: Ubuntu-24.04にインストール」を選択 |
| Git連携をWSL2のgitで行う | WSL2にgitをインストールするだけで自動連携される |
| GitHubにSSH鍵でpushする | WSL2内で ssh-keygen -t ed25519 を実行し公開鍵をGitHubに登録する |
| Python仮想環境を切り替える | Ctrl+Shift+P → 「Python: インタープリターを選択」 |
| WSL2のWebサーバーをWindowsブラウザで確認する | VS Codeが自動で通知 → 「ポート」タブで転送設定を確認する |
| GitHub CopilotをWSL2で使う | 拡張機能パネルでWSL2側にもCopilotをインストールする |
| プロジェクトのファイル操作を速くする | プロジェクトを/mnt/c以下ではなくWSL2の/home以下に置く |
| VPSのファイルをVS Codeで編集する | Remote - SSH拡張を使いコマンドパレットから「Connect to Host」で接続 |
| 「code: command not found」エラーを解消する | VS Codeを再インストールしてPATH追加にチェックを入れる |
| WSL2への接続を切断する | VS Code左下の「WSL: Ubuntu-24.04」をクリック → 「接続を閉じる」を選択 |
| チームで同じ環境を再現する | Dev Containersに移行してdevcontainer.jsonで環境を定義する |
関連記事 ~ 次に身につけるLinuxスキル
WSL2とVS Codeが使えるようになったら、次は実際のLinuxコマンドや設定を深く学んでいきましょう。以下の7つのテーマで、WSL2・VPS・クラウド環境でそのまま使える実践的なスキルを身につけられます。
・シェルスクリプト:set -xコマンドでシェルスクリプトをデバッグする方法|set -e・set -uとの組み合わせも ~ スクリプトのデバッグを素早く行う
・セキュリティ:fail2banコマンドでブルートフォース攻撃を自動ブロックする方法|SSHの不正アクセス対策も ~ SSHへの不正アクセスを自動でブロックする
・サーバー構築:scpコマンドでファイルを安全に転送する方法|公開鍵認証やディレクトリごとコピーも ~ VPSとWindowsの間でファイルを転送する
・トラブルシューティング:straceコマンドでプロセスのシステムコールを追跡する方法|Permission deniedの原因特定も ~ コマンドが動かない原因を深く調べる
・ネットワーク:nmcliコマンドでネットワーク接続を設定する方法|静的IP・DHCPの切替も ~ VPS・クラウドのネットワーク設定を理解する
・ディスク管理:lsblkコマンドでブロックデバイスを一覧表示する方法|ディスク構成やパーティション確認も ~ WSL2やVPSのストレージ状況を把握する
・現場Tips:watchコマンドで定期的にコマンドを繰り返し実行する方法|変化の検出やログ監視にも ~ コマンドを自動で繰り返して状態変化を監視する
無料の「Linuxサーバー構築入門マニュアル(図解60ページ)」をプレゼントしています。
WSL2やVS Codeでの学習をさらに深めたい方は、ぜひ受け取ってみてください。
無料マニュアルを受け取る >>
<PR>手元に置いて学びを深める1冊
Visual Studio Code完全入門 Webクリエイター&エンジニアの作業がはかどる新世代エディターの操り方
まず無料メルマガでLinuxの基礎を学ぶのが第一歩。VS Codeをさらに深く使いこなすには、本書でショートカット・拡張機能・WSL連携の全体像を体系的に身につけるのが近道です。
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら
- 次のページへ:GitHub CodespacesでLinuxを使う入門|インストールなしでブラウザからコマンドを動かす方法
- 前のページへ:WSL2のメモリ設定入門|.wslconfigでWindowsの動作を重くしない最適化手順
- この記事の属するカテゴリ:【Linux入門】初心者のための基礎知識・講座へ戻る

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます