できない.dev

nvm をインストールしたのに nvm コマンドが認識されない

nvm のインストーラを叩いた後に nvm: command not found になるのは、~/.bashrc や ~/.zshrc への source 行追記が反映されていない/別シェルを使っている/Windows 用 nvm-windows のパス未反映が原因。

公開: 更新:

症状できない · exit 127
nvm --version
bash: line 1: nvm: command not found
解決後できた · exit 0
. "$HOME/.nvm/nvm.sh"; nvm --version
0.40.1

2026-08-02 に node:20 で実際に打って取った出力。検証環境の詳細

要約

nvm のインストーラを実行した直後の同じターミナルで nvm: command not found が出るのは、シェル設定ファイルの再読み込みが行われていないだけのことが多い。
新しいターミナルを開くか source ~/.zshrc(bash なら ~/.bashrc)を叩けば認識される。
それでも出ない場合は設定ファイルの追記漏れを疑う。

source ~/.zshrc      # zsh
source ~/.bashrc     # bash

実行例

node:20(Debian GNU/Linux 12 bookworm)環境で上記の手順を試すと、source なしで nvm を呼び出した場合はコマンドが見つからず、終了コード 127 が返った。
nvm.sh を source してから呼び出すと、終了コード 0 で nvm 0.40.1 が正常に応答した。

$ ls ~/.nvm/nvm.sh
/root/.nvm/nvm.sh
$ nvm --version
bash: line 1: nvm: command not found
$ echo $?
127
$ . "$HOME/.nvm/nvm.sh"; nvm --version
0.40.1
$ echo $?
0

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
node:20

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. シェル設定の確認(Unix 系)

公式 README のスニペット(新しいタブで開く)が ~/.zshrc 等に追記されているか確認する。

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

無ければ手動で追記し、source ~/.zshrc で読み直す。

2. Windows: nvm-windows

公式インストーラ(新しいタブで開く)を実行したら、開いている すべての ターミナルを閉じてから新規に起動する。
PowerShell 7 / Windows Terminal / Git Bash で別個に確認するのが確実だ。

3. zsh の設定ファイルを統一

~/.zprofile と ~/.zshrc のどちらに書くか迷ったら ~/.zshrc を選ぶ。
対話シェルなら、ログインシェルかどうかに関係なく読まれる。

よくある原因

  1. シェルを再起動していない。
    nvm はインストール時に「現在のセッションを再起動するか source してください」と表示するが、見落として同じターミナルで叩くと認識されない。
  2. zsh を使っているのに、~/.bashrc しか編集されていない。
    古いドキュメントに従うと ~/.bashrc だけ追記されることがあるが、zsh は ~/.zshrc を読む。
  3. Windows の nvm-windows で、パスがターミナルに反映されていない。
    インストーラはシステム環境変数を更新するが、起動中のターミナルには反映されないので、ターミナルを全て閉じて開き直す必要がある。
  4. nvm の設定が ~/.zprofile にしか入っていない。
    このファイルはログインシェルでしか読まれないため、zsh -i のような非ログインの対話シェルでは command not found になる。
    IDE のターミナルは製品と OS で違い、VS Code の既定は macOS が zsh -l(ログインシェル)、Linux が zsh(非ログインシェル)である。