できない.dev

ターミナルから code コマンドで VSCode を起動できない

code: command not found は、VSCode の CLI を PATH に登録すれば直る。
macOS はコマンドパレットの Shell Command で登録し、Windows はインストール後にターミナルを開き直す。

公開: 更新:

要約

ターミナルで code . を実行して code: command not found(Windows では「'code' は、内部コマンドまたは外部コマンド…として認識されていません」)になるのは、VSCode の CLI が PATH に登録されていないためだ。
macOS はアプリ本体を入れただけでは code コマンドが使えず、コマンドパレットからの登録操作が必要である(macOS のセットアップ手順(新しいタブで開く))。
Windows はインストーラーが PATH を更新するが、既に開いているターミナルには反映されない。

解決策

1. macOS: Shell Command を実行する

VSCode でコマンドパレット(Cmd+Shift+P)を開き、shell command と入力して Shell Command: Install 'code' command in PATH を実行する。
その後ターミナルを開き直せば code が使える。

2. Windows: ターミナルを再起動する

code --version

インストール直後に上記が失敗する場合は、まずターミナルを閉じて開き直す。
それでも見つからない場合は一度サインアウトまたは再起動して環境変数を再読み込みする。

3. 手動で PATH に追加する

ユーザーインストールの既定では %LOCALAPPDATA%\Programs\Microsoft VS Code\bin に CLI 用のスクリプトがある。
このディレクトリを環境変数 PATH に追加すれば code コマンドが使えるようになる(macOS の zip 版は /Applications/Visual Studio Code.app/Contents/Resources/app/bin)。

4. WSL では初回に自動セットアップさせる

Windows 側に VSCode をインストールした状態で、WSL のシェルから code . を実行すると、必要なサーバーコンポーネントが自動で導入され、以後 WSL 内からも起動できる。

よくある原因

  1. macOS で登録操作をしていない。
    /Applications に VS Code.app を置いただけでは PATH に何も追加されない。
  2. Windows でターミナルを再起動していない。
    インストーラーは PATH を更新するが、起動済みのターミナルは古い PATH を持ち続ける(Windows のセットアップ手順(新しいタブで開く))。
  3. PATH 追加のオプションを外した。
    インストール時に「PATH への追加」のチェックを外すと、code コマンドは登録されない。
  4. zip / portable 版を使っている。
    展開しただけでは PATH に入らないため、手動で設定する必要がある。
  5. 実行環境を取り違えている。
    ホストに入れた VSCode は、SSH 接続先やコンテナ内のシェルからはそのままでは見えない。