VS CodeとWSL (Ubuntu) を連携｜ターミナルでLinux環境を快適操作【設定手順ガイド】

2025年3月27日

Windows上で開発を行っているけれど、Linuxのコマンドラインツールや開発環境を使いたい…そんな悩みを解決するのがWSL (Windows Subsystem for Linux) です。

さらに、Visual Studio Code (VS Code) と連携させることで、Windowsの使い慣れたエディタからシームレスにLinux環境を操作できるようになります。

この記事では、WSL (Ubuntu) をインストールし、VS Codeからそのターミナルを使えるようにするまでの具体的な手順を解説します。

なぜVS CodeとWSLを連携させるのか？

Windows上でLinux環境: WSLを使えば、仮想マシンを別途用意することなく、Windows上で直接Linuxディストリビューション（Ubuntuなど）を実行できます。
強力な開発ツール: Linuxには豊富な開発ツールやコマンドラインユーティリティがあります。これらをWindowsの開発フローに簡単に組み込めます。
VS Codeの統合: VS Codeの「Remote – WSL」拡張機能を使うことで、VS CodeがWSL内のファイルシステムやツールと直接連携します。あたかもLinuxマシン上でVS Codeを動かしているかのような体験が得られます。
ターミナルの統合: VS Codeに統合されたターミナルから、直接WSL (Ubuntu) のシェルを操作できます。ファイル編集とコマンド実行の行き来がスムーズになります。

Windows 10 バージョン 2004 以降 (ビルド 19041 以降) または Windows 11
- バージョンの確認: Win + Rキーで「ファイル名を指定して実行」を開き、winverと入力してEnter。
Visual Studio Codeがインストール済みであること
- 未インストールの場合は、VS Code公式サイトからダウンロードしてインストールしてください。

まず最初にWSLのインストールを行います。

手順は以下の記事を参照してください。

次に、VS CodeがWSLと連携するための拡張機能をインストールします。

拡張機能のインストールが完了したら、VS CodeをWSL環境に接続します。

F1 キーを押すか、Ctrl+Shift+P を押してコマンドパレットを開きます。
WSL と入力し、表示されたコマンドを選択します。
インストールされているディストリビューション（例: Ubuntu）を選択するように求められる場合があります。通常はデフォルトのものが表示されるので、それを選択します。
新しいVS Codeウィンドウが開き、WSLに接続されます。ウィンドウ左下の緑色の部分に「WSL: Ubuntu」（または選択したディストリビューション名）と表示されていれば成功です。

WSL：ディストリビューションを使用してWSLに接続をクリックします。

Ubuntuをクリックします。

VS CodeがWSLに接続された状態（左下に「WSL: Ubuntu」などと表示されている状態）で、統合ターミナルを開くと、それが自動的にWSL (Ubuntu) のシェルになります。

画面上部メニューターミナルから新しいターミナルを選択します。

画面下部にターミナルが表示され、コマンドが入力できるようになりました。

試してみましょう。

# ターミナルで確認してみましょう
uname -a       # Linuxカーネル情報を表示
ls -l          # カレントディレクトリのファイル一覧を表示
pwd            # カレントディレクトリのパスを表示

これで、VS Codeのエディタでコードを書きながら、同じウィンドウ内のターミナルでLinuxコマンドを実行したり、ビルドやテストを行ったりできるようになりました！

ファイルアクセス: VS Codeのファイルエクスプローラーは、WSL内のファイルシステムを直接表示・編集できます。Windows側のファイルは /mnt/c/ などからアクセス可能です。
Linuxツールのインストール: Ubuntuターミナルから sudo apt update && sudo apt install <パッケージ名> で必要なツール（例: git, nodejs, python3, dockerなど）をインストールできます。
デバッグ: VS Codeのデバッグ機能もWSL内でシームレスに動作します（言語ごとのデバッグ用拡張機能が必要な場合があります）。
Git連携: VS CodeのGit機能も、WSL内のGitリポジトリに対して問題なく動作します。