VSCodeのターミナルを変更する方法について

VSCodeには「統合ターミナル」という機能があり、エディタを閉じることなくコマンドを実行できます。

たとえば、VSCode上で次のようなコマンドを実行可能です。

npm install
git status
python main.py
node app.js

VSCodeのターミナルでは、PowerShellやコマンドプロンプト、Git Bash、bash、zshなど、さまざまなシェルを使用できます。

そのため、「VSCodeのターミナルを変更する」とは、基本的には統合ターミナルで使用するシェルを変更することを意味します。

たとえばWindowsの場合、PowerShellからGit Bashへ変更したり、Command Promptへ切り替えたりできます。

VSCodeのターミナルを変更する基本的な方法

VSCodeで使用するターミナルを変更する場合、もっとも簡単なのは「Terminal: Select Default Profile」を利用する方法です。

コマンドパレットを開く

まず、VSCodeのコマンドパレットを開きます。

WindowsやLinuxでは、次のショートカットキーを使用します。

Ctrl + Shift + P

macOSの場合は、次のショートカットです。

Command + Shift + P

コマンドパレットが表示されたら、検索欄に次のコマンドを入力します。

Terminal: Select Default Profile

使用したいターミナルを選択する

「Terminal: Select Default Profile」を実行すると、現在利用できるターミナルプロファイルが表示されます。

Windowsでは、環境によって次のような選択肢があります。

PowerShell
Command Prompt
Git Bash
WSL

macOSでは、主に次のようなシェルが表示されます。

zsh
bash

Linuxの場合は、インストールされている環境によって次のようなシェルを選択できます。

bash
zsh
fish

使用したいターミナルを選択すれば、デフォルトのターミナルとして設定されます。

新しいターミナルを開く

デフォルトプロファイルを変更しても、すでに起動しているターミナルが自動的に切り替わるわけではありません。

現在開いているターミナルを終了し、新しいターミナルを起動する必要があります。

VSCodeのメニューから、次の順番で操作します。

Terminal
↓
New Terminal

WindowsやLinuxでは、次のショートカットでも新しいターミナルを開けます。

Ctrl + Shift + `

新しいターミナルを開くと、設定したシェルが使用されます。

ターミナル右上のメニューから切り替える方法

VSCodeでは、コマンドパレットを使わずにターミナルを切り替えることもできます。

「▼」から使用するターミナルを選択する

VSCodeで統合ターミナルを開くと、ターミナルパネルの右上付近に「＋」や「▼」のボタンがあります。

「▼」をクリックすると、利用可能なターミナルプロファイルが表示されます。

Windowsの場合、たとえば次のような項目が表示されます。

PowerShell
Command Prompt
Git Bash

ここから使用したいシェルを選択すると、そのシェルを利用した新しいターミナルを起動できます。

ただし、この方法は一時的に別のターミナルを開きたい場合に便利な方法です。

今後も常に特定のシェルを使用したい場合は、「Terminal: Select Default Profile」でデフォルトプロファイルを変更するとよいでしょう。

WindowsでPowerShellからGit Bashに変更する方法

WindowsでWeb開発をしている場合、PowerShellからGit Bashへ変更したいケースもあります。

Git Bashを利用すると、WindowsでもLinuxやmacOSに近いコマンドを使用しやすくなります。

Git Bashをデフォルトに設定する

まず、次のショートカットでコマンドパレットを開きます。

Ctrl + Shift + P

続いて、次のコマンドを検索します。

Terminal: Select Default Profile

一覧から「Git Bash」を選択します。

その後、現在開いているターミナルを終了し、新しいターミナルを開きます。

Git Bashが起動すると、環境によっては次のような表示になります。

user@DESKTOP-XXXX MINGW64 ~/project
$

「MINGW64」などと表示されていれば、Git Bashが起動している可能性が高いです。

Git Bashが表示されない場合

「Terminal: Select Default Profile」の一覧にGit Bashが表示されない場合は、Git for Windowsがインストールされているか確認しましょう。

次のコマンドを実行します。

git --version

Gitがインストールされていれば、次のようなバージョン情報が表示されます。

git version 2.x.x.windows.x

Gitそのものがインストールされていない場合は、Git for Windowsをインストールする必要があります。

WindowsでCommand Promptに変更する方法

PowerShellではなく、従来のコマンドプロンプトを使用することもできます。

Command Promptを選択する

コマンドパレットを開きます。

Ctrl + Shift + P

続いて、次のコマンドを選択します。

Terminal: Select Default Profile

一覧から「Command Prompt」を選択します。

新しいターミナルを開き、次のような表示になればコマンドプロンプトが起動しています。

C:\Users\username>

古いWindows向けのツールやコマンドを使用する場合などに便利です。

PowerShellをデフォルトターミナルにする方法

WindowsではPowerShellを使用することもできます。

PowerShellを選択する

次のショートカットでコマンドパレットを開きます。

Ctrl + Shift + P

「Terminal: Select Default Profile」を実行し、「PowerShell」を選択します。

新しいターミナルを開けばPowerShellが起動します。

PowerShellでは、たとえば次のようなコマンドを使用できます。

Get-ChildItem

もちろん、PATHが正しく設定されていれば、次のような開発用コマンドも利用できます。

git
node
npm
python

macOSでVSCodeのターミナルを変更する方法

macOSでも、基本的な変更方法はWindowsと同じです。

zshやbashを選択する

次のショートカットでコマンドパレットを開きます。

Command + Shift + P

続いて、次のコマンドを実行します。

Terminal: Select Default Profile

一覧から「zsh」や「bash」などを選択します。

その後、新しいターミナルを開けば設定が反映されます。

macOSではzshが標準的に使用されることが多いため、特別な理由がなければzshを利用しても問題ありません。

LinuxでVSCodeのターミナルを変更する方法

Linuxでも「Terminal: Select Default Profile」から使用するシェルを変更できます。

bash・zsh・fishなどを選択する

まず、次のショートカットを使用します。

Ctrl + Shift + P

次に「Terminal: Select Default Profile」を実行します。

環境によっては、次のようなシェルが表示されます。

bash
zsh
fish

利用したいものを選択し、新しいターミナルを開きます。

ただし、使用したいシェルがOSにインストールされている必要があります。

たとえばzshがインストールされているか確認する場合は、次のコマンドを使用できます。

zsh --version

fishの場合は、次のように確認します。

fish --version

settings.jsonからターミナルを変更する方法

VSCodeでは、GUIから設定するだけでなく「settings.json」を直接編集してターミナルを変更することもできます。

細かくターミナル環境を管理したい場合に便利です。

Windowsの場合

WindowsでGit Bashをデフォルトにする場合は、次のように設定します。

{
  "terminal.integrated.defaultProfile.windows": "Git Bash"
}

PowerShellを使用する場合は、次のように設定できます。

{
  "terminal.integrated.defaultProfile.windows": "PowerShell"
}

macOSの場合

macOSでは「osx」を使用します。

zshをデフォルトにする場合は、次のように設定します。

{
  "terminal.integrated.defaultProfile.osx": "zsh"
}

Linuxの場合

Linuxでbashを使用する場合は、次のように設定します。

{
  "terminal.integrated.defaultProfile.linux": "bash"
}

OSによって設定名が異なる点に注意しましょう。

Windows
terminal.integrated.defaultProfile.windows

macOS
terminal.integrated.defaultProfile.osx

Linux
terminal.integrated.defaultProfile.linux

独自のターミナルプロファイルを設定する方法

VSCodeでは、既存のターミナルを選ぶだけでなく、独自のターミナルプロファイルを作成することもできます。

PowerShellをオプション付きで起動する

たとえば、PowerShellを「-NoProfile」オプション付きで起動したい場合は、次のように設定できます。

{
  "terminal.integrated.profiles.windows": {
    "PowerShell -NoProfile": {
      "source": "PowerShell",
      "args": [
        "-NoProfile"
      ]
    }
  },
  "terminal.integrated.defaultProfile.windows": "PowerShell -NoProfile"
}

この設定を行うと、「PowerShell -NoProfile」という独自のターミナルプロファイルを利用できます。

起動時の引数や環境変数などを細かく設定したい場合に便利です。

ターミナルの実行ファイルを直接指定する方法

使用したいシェルの実行ファイルを直接指定することもできます。

Windowsの場合

たとえば、コマンドプロンプトを独自のプロファイルとして登録する場合は次のように設定します。

{
  "terminal.integrated.profiles.windows": {
    "My Command Prompt": {
      "path": "C:\\Windows\\System32\\cmd.exe"
    }
  },
  "terminal.integrated.defaultProfile.windows": "My Command Prompt"
}

Linuxの場合

Linuxでzshを直接指定する場合は、次のように設定できます。

{
  "terminal.integrated.profiles.linux": {
    "My Zsh": {
      "path": "/bin/zsh"
    }
  },
  "terminal.integrated.defaultProfile.linux": "My Zsh"
}

シェルが自動検出されない場合や、特定の実行ファイルを使用したい場合に役立ちます。

プロジェクトごとにVSCodeのターミナルを変更する方法

VSCodeでは、すべてのプロジェクトで同じターミナルを使う必要はありません。

ワークスペースごとに異なるターミナルを設定できます。

.vscode/settings.jsonを設定する

プロジェクトフォルダ内にある次のファイルを使用します。

.vscode/settings.json

たとえばWindowsで、特定のプロジェクトだけGit Bashを使用する場合は、次のように設定します。

{
  "terminal.integrated.defaultProfile.windows": "Git Bash"
}

これにより、普段はPowerShellを使用しながら、特定のプロジェクトだけGit Bashを使用するといった使い分けができます。

複数の開発環境を扱っている場合に便利です。

WSLをVSCodeのターミナルとして使用する方法

Windowsでは、WSLをVSCodeのターミナルとして利用することもできます。

WSLとは「Windows Subsystem for Linux」の略で、Windows上でLinux環境を利用するための仕組みです。

WSLをターミナルプロファイルとして選択する

WSLを導入している場合、「Terminal: Select Default Profile」の一覧に次のような項目が表示される場合があります。

Ubuntu (WSL)

WSLを使用すると、Linux環境のコマンドを利用できます。

apt
bash
ssh
grep
sed

Linuxサーバー上で動作するWebアプリケーションを開発している場合などは、Windows上でもLinuxに近い環境を構築できることがメリットです。

PowerShell・Git Bash・WSLの違い

Windowsでは、PowerShell、Git Bash、WSLのどれを使用すべきか迷うことがあります。

それぞれ特徴が異なります。

ターミナル	特徴	向いている用途
PowerShell	Windowsとの親和性が高い	Windows開発、一般用途
Command Prompt	シンプルで従来型	古いWindowsツール
Git Bash	Linux風のコマンドを使いやすい	Git、Web開発
WSL	Windows上で本格的なLinux環境を利用できる	Web開発、バックエンド、Dockerなど
zsh	macOSで広く使用される	macOSでの開発
bash	Linuxで一般的	Linux、サーバー開発

Web開発ではGit BashやWSLも便利

GitやNode.js、npm、React、Next.js、Python、Docker、SSHなどを使用するWeb開発では、Git BashやWSLが使いやすいケースがあります。

Git Bashは、Windows環境を維持しながらLinux風のコマンドを使いたい場合に便利です。

一方、WSLはWindows上でより本格的なLinux環境を使用できます。

本番環境がLinuxサーバーの場合は、WSLを使用することで開発環境との差を小さくできる可能性があります。

VSCodeのターミナルを変更しても反映されない場合

設定を変更したにもかかわらず、以前のターミナルが表示され続けることがあります。

現在のターミナルを終了する

「Terminal: Select Default Profile」で変更した設定は、すでに起動しているターミナルには反映されません。

一度現在のターミナルを終了し、新しいターミナルを作成してください。

Terminal
↓
New Terminal

デフォルトプロファイルを確認する

新しいターミナルでも変更されない場合は、もう一度コマンドパレットから次の設定を確認します。

Terminal: Select Default Profile

意図したターミナルが選択されているか確認しましょう。

settings.jsonを確認する

さらに、settings.jsonに古い設定が残っていないか確認することも重要です。

Windowsの場合は、たとえば次の項目を確認します。

"terminal.integrated.defaultProfile.windows"

複数の設定が競合していると、意図したターミナルが起動しない場合があります。

Git BashがVSCodeに表示されない場合

Git Bashを使用したいのに候補に表示されない場合は、Gitのインストール状況や設定を確認しましょう。

Gitがインストールされているか確認する

次のコマンドを実行します。

git --version

正常にインストールされていれば、Gitのバージョンが表示されます。

Git Bashを手動で登録する

Git Bashが自動検出されない場合は、settings.jsonから登録することもできます。

たとえば、Git Bashが次の場所にインストールされている場合です。

C:\Program Files\Git\bin\bash.exe

settings.jsonに次のように設定します。

{
  "terminal.integrated.profiles.windows": {
    "Git Bash": {
      "path": "C:\\Program Files\\Git\\bin\\bash.exe"
    }
  },
  "terminal.integrated.defaultProfile.windows": "Git Bash"
}

ただし、Gitのインストール場所によってパスは異なるため、実際の環境に合わせて変更する必要があります。

VSCodeの「プロファイル」と「ターミナルプロファイル」の違い

VSCodeには「Profiles」と「Terminal Profiles」という似た名称の機能がありますが、両者は異なります。

VSCode Profilesとは

VSCode Profilesは、VSCode全体の環境を切り替えるための機能です。

たとえば、次のような設定をまとめて管理できます。

設定
拡張機能
UIレイアウト
キーボード設定

用途ごとにVSCodeの環境を切り替えたい場合に使用します。

Terminal Profilesとは

Terminal Profilesは、VSCodeの統合ターミナルで使用するシェルを設定するための機能です。

たとえば、次のようなシェルを管理します。

PowerShell
Command Prompt
Git Bash
WSL
zsh
bash

単純に使用するターミナルを変更したい場合は、Terminal Profilesを設定すれば問題ありません。

VSCodeのターミナルを変更するなら「Select Default Profile」が簡単

VSCodeのターミナルを変更する方法はいくつかありますが、通常はsettings.jsonを直接編集する必要はありません。

もっとも簡単なのは、次の手順です。

Ctrl + Shift + P
↓
Terminal: Select Default Profile
↓
使用したいターミナルを選択
↓
現在のターミナルを終了
↓
New Terminalで新しいターミナルを開く

Windowsの場合は、PowerShell、Command Prompt、Git Bash、WSLなどから選択できます。

一時的に別のターミナルを使用したい場合は、ターミナルパネルの「▼」から選択する方法も便利です。

また、プロジェクトごとにターミナルを変更したい場合や、起動オプションを細かく設定したい場合は、settings.jsonを活用するとよいでしょう。

Web開発ではPowerShellでも十分に作業できますが、Linux系のコマンドを利用したい場合はGit Bash、本番環境に近いLinux環境で開発したい場合はWSLというように、用途に応じて使い分けるのがおすすめです。

以上、VSCodeのターミナルを変更する方法についてでした。

最後までお読みいただき、ありがとうございました。