VSCodeで「command not found: code」が出た時の解決方法【PATH設定を基礎から解説】

VSCode

VSCodeのチュートリアル通りに code . とターミナルに入力したのに command not found: code と表示されてしまった、という経験はありませんか。このエラーはVSCodeのインストール自体の問題ではなく、OSの「PATH」という設定にVSCodeが登録されていないことが原因です。正しい手順を踏めば2分で解決できます。

この記事でわかること

  • 「command not found: code」が発生する根本原因（PATHとは何か）
  • VSCodeのコマンドパレットを使った最短の解決手順
  • 解決後の動作確認方法

エラーの根本原因：PATHとは何か

ターミナルでコマンドを入力すると、OSは「どこにそのコマンドの実行ファイルがあるか」を探します。この「探しに行く場所のリスト」が PATH（環境変数） です。

たとえば ls コマンドを打つと、OSは /bin/ls という実行ファイルを見つけて実行します。/bin はPATHに登録されているため、フルパスを書かなくてもコマンドが動きます。

code コマンドの実行ファイルはVSCodeのアプリケーションバンドル内に存在しますが、VSCodeをインストールしただけではそのパスがOSのPATHに自動登録されません。そのため、ターミナルは code コマンドの実行ファイルを見つけられず、command not found: code を返します。

ポイント

PATHとは「ターミナルがコマンドを探しに行くディレクトリの一覧」です。echo $PATH を実行するとコロン区切りで登録済みのパスが表示されます。

解決手順：VSCodeのコマンドパレットからPATHを通す

VSCodeにはPATHへの登録を自動で行う機能が組み込まれています。以下の手順で実行してください。

  1. VSCodeを起動する

    FinderまたはアプリケーションフォルダからVSCodeを起動します。ターミナルではなく、GUIからVSCodeを開いてください。

  2. コマンドパレットを開く

    Macの場合は Cmd + Shift + P、Windowsとの共用環境やLinuxでは Ctrl + Shift + P を押してコマンドパレットを開きます。

  3. 「Shell Command」を検索して実行する

    コマンドパレットの入力欄に shell command と入力すると、候補に Shell Command: Install ‘code’ command in PATH が表示されます。これをクリックして実行してください。

    # 実行後、以下のような成功メッセージがVSCode右下に表示されます
Shell command 'code' successfully installed in PATH.
  4. ターミナルを完全に再起動する

    PATHの変更を反映させるため、現在開いているターミナルを一度完全に終了し、新しいターミナルウィンドウを開いてください。ターミナルアプリの再起動が必要です（タブを閉じるだけでは不十分な場合があります）。

動作確認

新しいターミナルウィンドウを開いて以下のコマンドを実行してください。

code --version
# 出力:
1.89.1
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
x64

バージョン番号が表示されれば成功です。続いて実際に任意のディレクトリをVSCodeで開いてみます。

cd ~/Desktop
code .
# 出力:
# （VSCodeが起動し、Desktopフォルダが開かれる）

よくある関連エラーと対処法

  • 再起動後もエラーが解消されない（Mac）：シェルが bash か zsh か確認してください。echo $SHELL で確認し、zsh なら ~/.zshrc、bash なら ~/.bash_profile に export PATH="$PATH:/usr/local/bin" が存在するか確認してください。
  • 「Shell Command: Install ‘code’ command in PATH」が候補に出ない：VSCodeのバージョンが古い可能性があります。VSCode内の「Help」→「Check for Updates」から最新版に更新してください。
  • Windowsで同じ操作をしたい：WindowsではVSCodeインストール時に「PATHへの追加」チェックボックスが表示されます。インストーラーを再実行して「Add to PATH」にチェックを入れて上書きインストールしてください。

まとめ

  • command not found: code はVSCodeの実行ファイルがOSのPATHに登録されていないことが原因
  • VSCodeのコマンドパレット（Cmd/Ctrl + Shift + P）から「Shell Command: Install ‘code’ command in PATH」を実行することで解決する
  • 実行後はターミナルを完全に再起動してPATHの変更を反映させる

関連記事

コメント

タイトルとURLをコピーしました