Node.jsが動かないときはnvmを再設定!Windows 11で「nodeが認識されない」原因と直し方

Node.jsが動かないときはnvmを再設定!Windows 11で「nodeが認識されない」原因と直し方

Node.jsをインストールしたはずなのに、Windows Terminalやコマンドプロンプトで「node」と入力しても動かないことがあります。

特にnvmを使ってNode.jsのバージョンを管理している環境では、nvmの設定、Node.jsの切り替え、PATHの状態が原因で「nodeが認識されない」というトラブルが起こることがあります。

私も以前、Node.jsのバージョンを切り替えた直後に「node –version」が通らなくなり、Node.jsそのものが壊れたと思って再インストールしかけたことがあります。しかし原因は、nvmで使用するNode.jsのバージョンが正しく選択されていなかったことでした。

この記事では、Windows 11を使っている初心者向けに、Node.jsが動かないときの確認方法とnvmの再設定方法を、安全な順番で解説します。

  1. Node.jsが動かないときによくある症状
  2. そもそもnvmとは?初心者向けに解説
  3. Node.jsが動かなくなる主な原因
  4. まずnvmが動くか確認する
  5. Node.jsが動くか確認する
  6. nvmに入っているNode.jsを確認する
  7. Node.jsのバージョンを選び直す
  8. 「nvm use」を実行してもNode.jsが動かない場合
  9. nvmの場所も確認する
  10. PATHとは?Node.jsとnvmで重要な理由
  11. Windows 11でPATHを確認する方法
  12. nvmのPATHを確認するときのポイント
  13. 設定変更前にスクリーンショットを取る
  14. Node.jsを単体インストールしていた場合は競合に注意
    1. どのNode.jsが呼び出されているか確認する
  15. 私がnvmの再設定で失敗した体験談
  16. ターミナルを開き直す
  17. VS CodeだけNode.jsが動かない場合
  18. npmが動かない場合の確認方法
  19. nvmでNode.jsを入れ直す方法
  20. プロジェクトごとに必要なNode.jsを確認する
  21. nvm再設定後の確認手順
  22. Windowsを再起動するときの確認ポイント
  23. 便利なショートカットキー
  24. Node.jsが使えると仕事や日常で何が便利?
  25. 応用編:プロジェクトを切り替えたらNode.jsのバージョンも確認する
  26. Node.jsとnvmのトラブルを予防する方法
  27. 危険性あり:nvmやNode.jsのフォルダーを直接削除しない
  28. 最終手段:nvmを再インストールする前に確認すること
  29. Node.jsが動かないときのおすすめ確認順序
  30. よくある質問
    1. nvmは動くのにnodeが動きません
    2. nvm useを実行してもnodeが認識されません
    3. node –versionで古いバージョンが表示されます
    4. npmだけ動かないのはなぜですか?
    5. nvmを再インストールすれば必ず直りますか?
    6. Windows Terminalでは動くのにVS Codeでは動きません
    7. Node.jsを直接インストールしていてもnvmを使えますか?
    8. nvmでどのNode.jsを使えばいいですか?
    9. Windows 10でも同じ方法で確認できますか?
  31. まとめ|Node.jsが動かないときはnvmを再設定して順番に確認しよう
    1. 共有:
    2. 関連

Node.jsが動かないときによくある症状

nvmやPATHに問題があると、次のような症状が発生することがあります。

  • 「node」と入力しても認識されない
  • 「node –version」でエラーになる
  • 「npm」が使えない
  • nvmでNode.jsを切り替えたのに反映されない
  • VS CodeのターミナルだけNode.jsが動かない
  • 以前は使えていたNode.jsが突然動かなくなった
  • 別のバージョンのNode.jsが起動してしまう
  • nvmでインストールしたNode.jsが見つからない

この状態でも、すぐにNode.jsやnvmをすべて削除する必要はありません。

まず現在の状態を確認し、そのあとnvmの設定を見直すのが安全です。

そもそもnvmとは?初心者向けに解説

nvmは、複数のNode.jsを切り替えて使うためのバージョン管理ツールです。

Node.jsは、JavaScriptをパソコン上で実行するための環境です。Web制作やWebアプリ開発では、npmと呼ばれるパッケージ管理ツールと一緒に使われることが多くあります。

プロジェクトによって必要なNode.jsのバージョンが違うことがあるため、nvmを使うと状況に合わせて切り替えられます。

たとえば、仕事で使うプロジェクトではあるバージョン、新しく作るプロジェクトでは別のバージョンという使い分けが可能です。

ただしWindowsでは、一般的にWindows向けのnvm環境を利用します。macOSやLinux向けのnvmとは仕組みや操作が一部異なるため、インターネット上の記事を参考にするときは注意が必要です。

Node.jsが動かなくなる主な原因

nvmを使っている環境でNode.jsが動かなくなる場合、よくある原因は次のとおりです。

  • nvm自体が認識されていない
  • Node.jsがnvmにインストールされていない
  • 使用するNode.jsのバージョンが選択されていない
  • PATHの設定がおかしい
  • Node.jsを単体インストールした設定とnvmが競合している
  • 複数のNode.jsがPATHに登録されている
  • ターミナルを開き直していない
  • VS Codeが古い環境変数を読み込んでいる
  • nvmの管理フォルダーやシンボリックリンクに問題がある

特に、Node.jsを直接インストールしたあとでnvmを導入した場合は、複数のNode.js環境が混在している可能性があります。

まずnvmが動くか確認する

最初に、nvm自体がWindowsから認識されているか確認します。

Windows Terminalまたはコマンドプロンプトを開き、次のコマンドを入力します。

nvm version

nvmのバージョン情報が表示されれば、nvm自体は認識されています。

一方、「nvmが認識されていません」といった内容のエラーが表示される場合は、Node.jsではなくnvm側のインストールやPATH設定に問題がある可能性があります。

Node.jsが動くか確認する

次にNode.jsの状態を確認します。

node --version

正常なら、Node.jsのバージョン番号が表示されます。

あわせてnpmも確認しましょう。

npm --version

Node.jsは動くのにnpmだけ動かない場合は、nvmそのものではなくNode.js環境やPATHに問題がある可能性があります。

nvmに入っているNode.jsを確認する

nvmが動く場合は、現在インストールされているNode.jsの一覧を確認します。

nvm list

環境によっては次のコマンドでも確認できます。

nvm ls

インストールされているNode.jsのバージョンが一覧表示されます。

現在使用中のバージョンには目印が表示されることがあります。

ここで何もNode.jsが表示されない場合は、nvm自体は入っていてもNode.jsがインストールされていない可能性があります。

Node.jsのバージョンを選び直す

Node.jsがnvmにインストールされているのに「node」が動かない場合は、使用するバージョンを選び直します。

まず「nvm list」で表示されたバージョンを確認してください。

そのうえで、次の形式で切り替えます。

nvm use 使用するバージョン

たとえば、一覧に表示されているNode.jsを指定して切り替えます。

切り替え後は、次のコマンドで確認してください。

node --version

表示されたバージョンが「nvm use」で指定したものと一致していれば、基本的な切り替えは成功しています。

「nvm use」を実行してもNode.jsが動かない場合

「nvm use」は成功したように見えるのに「node –version」が通らない場合は、PATHやnvmのリンク設定に問題がある可能性があります。

まず、WindowsがどのNode.jsを見つけているか確認します。

where node

Node.jsの場所が表示されれば、Windowsは何らかのNode.jsを認識しています。

何も表示されない場合やエラーになる場合は、nvmで切り替えたNode.jsの場所がWindowsから正常に参照できていない可能性があります。

nvmの場所も確認する

同じようにnvmの場所も確認できます。

where nvm

nvmの実行ファイルがある場所が表示されます。

ここで想定外の場所が表示されたり、複数のnvmが見つかったりする場合は、古いnvm環境が残っている可能性があります。

PATHとは?Node.jsとnvmで重要な理由

PATHとは、Windowsがプログラムを探すために使うフォルダー一覧です。

Windows Terminalで「node」と入力すると、WindowsはPATHに登録されている場所を順番に確認し、Node.jsの実行ファイルを探します。

そのため、nvmでNode.jsを正しくインストールしていても、PATHの設定がおかしいと「nodeが見つからない」という状態になります。

反対に、古いNode.jsのPATHが残っていると、nvmで切り替えたNode.jsではなく別のNode.jsが先に起動することもあります。

Windows 11でPATHを確認する方法

PATHを確認する場合は、環境変数の設定画面を開きます。

  1. スタートボタンをクリックします。
  2. 検索欄に「環境変数」と入力します。
  3. 「システム環境変数の編集」を開きます。
  4. 「環境変数」をクリックします。
  5. 「Path」を選択します。
  6. 「編集」をクリックします。

ここにはさまざまなプログラムの保存場所が登録されています。

意味のわからない項目を削除しないでください。別のアプリが動かなくなる可能性があります。

nvmのPATHを確認するときのポイント

Windows向けのnvmでは、nvmが管理するフォルダーと、現在選択しているNode.jsへつながる場所がPATHから利用されます。

環境によって保存場所は異なるため、インターネットで見つけたパスをそのままコピーするのは避けましょう。

確認するときは、次の点を見ます。

  • nvmの管理フォルダーが存在しているか
  • Node.js用に設定された場所が存在しているか
  • 古いNode.jsのフォルダーがPATHに残っていないか
  • 同じようなNode.jsのPATHが重複していないか

どの項目が必要かわからない場合は、削除する前に現在のPATHを記録しておきましょう。

設定変更前にスクリーンショットを取る

環境変数を変更するときは、元の状態をスクリーンショットで残しておくと安心です。

Windows 11では次のショートカットキーを使えます。

Windowsキー + Shift + S

画面の一部を画像として記録できます。

PATHを削除・追加する前に保存しておけば、問題が起きたときに元の状態を確認できます。

Node.jsを単体インストールしていた場合は競合に注意

nvmを導入する前に、Node.js公式インストーラーなどを使ってNode.jsを直接インストールしていた場合は注意が必要です。

パソコン内に、次のような2種類の環境が存在している可能性があります。

  • 直接インストールしたNode.js
  • nvmが管理しているNode.js

両方がPATHに残っていると、「nvm use」で切り替えたのに別バージョンが起動するなどのトラブルにつながります。

どのNode.jsが呼び出されているか確認する

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

where node

複数の場所が表示された場合は、Node.jsが複数存在している可能性があります。

表示された場所を確認せず、いきなりフォルダーを削除しないでください。

私がnvmの再設定で失敗した体験談

以前、あるプロジェクトを動かすためにNode.jsのバージョンを切り替えたところ、突然「node –version」が動かなくなったことがあります。

私は最初、「Node.jsのインストールが壊れた」と思い込み、nvmごと削除して再インストールしようとしました。

しかし、その前に「nvm list」を確認するとNode.js自体は残っていました。

さらに確認すると、使用するNode.jsのバージョンが正常に選択されていなかったため、改めて「nvm use」で切り替えたところ動作しました。

この経験から、Node.jsが動かないからといって、すぐ再インストールする必要はないと感じています。

まず「nvm version」「nvm list」「node –version」の順番で確認すると、原因を見つけやすくなります。

ターミナルを開き直す

nvmやPATHの設定を変更したあと、すでに開いているWindows Terminalやコマンドプロンプトでは変更が反映されないことがあります。

  1. 開いているWindows Terminalを閉じます。
  2. コマンドプロンプトも閉じます。
  3. VS Codeを使用している場合はVS Codeも閉じます。
  4. Windows Terminalを新しく開きます。
  5. 「node –version」を確認します。

設定を変更したあとは、新しいターミナルで確認することが大切です。

VS CodeだけNode.jsが動かない場合

Windows TerminalではNode.jsが動くのに、VS Codeのターミナルだけ「nodeが認識されない」ということがあります。

これはVS Codeが起動時点の環境変数を読み込んだままになっている可能性があります。

  1. 編集中のファイルを保存します。
  2. VS Codeを完全に終了します。
  3. Windows Terminalで「node –version」を確認します。
  4. 正常ならVS Codeを起動し直します。
  5. VS Codeの新しいターミナルを開きます。
  6. もう一度「node –version」を確認します。

Windows Terminalでは正常なのにVS Codeだけ動かない場合は、nvmを再インストールする前にVS Codeの再起動を試しましょう。

npmが動かない場合の確認方法

Node.jsは動くのにnpmだけ動かない場合は、まず次のコマンドを確認します。

npm --version

エラーが表示される場合は、現在のNode.js環境が正しく切り替わっているか確認します。

nvm list

続けて次のコマンドを確認します。

node --version

Node.jsの切り替えが不完全な場合は、npmも正常に利用できないことがあります。

nvmでNode.jsを入れ直す方法

nvm自体は正常なのに、特定のNode.jsだけ動かない場合は、そのNode.jsをnvm経由で入れ直す方法があります。

まず現在の状態を確認します。

nvm list

そのうえで、必要なNode.jsをインストールします。

nvm install バージョン

インストール後は、そのバージョンを選択します。

nvm use バージョン

最後に確認します。

node --version

プロジェクトが必要としているNode.jsのバージョンを確認してからインストールしてください。

プロジェクトごとに必要なNode.jsを確認する

Node.jsが動いたとしても、プロジェクトが要求するバージョンと違えばエラーになることがあります。

たとえば、古いプロジェクトでは新しいNode.jsで正常に動かないケースがあります。

反対に、新しいツールでは古いNode.jsがサポートされていないこともあります。

プロジェクトの説明書や設定ファイル、チーム内のルールなどを確認して、必要なNode.jsをnvmで選びましょう。

単純に「一番新しいNode.jsを使えばよい」とは限りません。

nvm再設定後の確認手順

nvmを設定し直したら、次の順番で確認するとわかりやすいです。

  1. Windows Terminalを新しく開きます。
  2. 「nvm version」を実行します。
  3. 「nvm list」を実行します。
  4. 必要なバージョンを「nvm use」で選びます。
  5. 「node –version」を実行します。
  6. 「npm –version」を実行します。
  7. 「where node」で実際の場所を確認します。

この確認でnvm、Node.js、npmがすべて正常なら、基本的な環境は復旧しています。

Windowsを再起動するときの確認ポイント

通常はターミナルを開き直せば十分ですが、PATH変更後も状態が変わらない場合はWindowsを再起動すると改善することがあります。

再起動する前に次の点を確認してください。

  • VS Codeで編集中のファイルを保存したか
  • ターミナルで処理中のコマンドがないか
  • 環境変数の変更を保存したか
  • PATHの変更前の状態を記録したか

確認できたら、Windows 11のスタートメニューから「電源」→「再起動」を選択します。

再起動後、Windows Terminalで次のコマンドを実行します。

nvm list
node --version
npm --version

すべて正常に表示されるか確認しましょう。

便利なショートカットキー

Node.jsやnvmの設定を確認するときは、Windowsのショートカットキーを使うと作業が楽になります。

  • Windowsキー + R:「ファイル名を指定して実行」を開きます。
  • Windowsキー + E:エクスプローラーを開きます。
  • Ctrl + C:文字やファイルをコピーします。
  • Ctrl + V:コピーした内容を貼り付けます。
  • Windowsキー + Shift + S:画面の一部をスクリーンショットします。

エラー画面やPATHの設定を記録しておくと、元の状態へ戻したいときにも役立ちます。

Node.jsが使えると仕事や日常で何が便利?

Node.jsが正常に動作すると、Web制作や開発で必要なさまざまなツールを利用できるようになります。

  • npmでパッケージをインストールできる
  • Webサイトの開発環境を動かせる
  • JavaScriptやTypeScriptの開発ができる
  • Reactなどを使った開発を進められる
  • 開発用サーバーを起動できる
  • 繰り返し作業を自動化できる

nvmを使ってNode.jsを管理できるようになると、複数の案件やプロジェクトでも必要なバージョンへ切り替えやすくなります。

仕事で複数のWebサイトを管理している場合にも便利です。

応用編:プロジェクトを切り替えたらNode.jsのバージョンも確認する

nvmを使う大きなメリットは、プロジェクトごとにNode.jsを切り替えられることです。

ただし、プロジェクトを移動しただけでは、自動的に必要なNode.jsへ切り替わらない環境もあります。

別のプロジェクトを開いたときは、次のコマンドで現在のバージョンを確認する習慣を付けると安心です。

node --version

必要に応じて「nvm use」で切り替えます。

これだけでも「昨日まで動いたのに今日は動かない」というトラブルを減らせます。

Node.jsとnvmのトラブルを予防する方法

nvmを安定して使うためには、普段から次の点を意識しましょう。

  • Node.jsをむやみに複数の方法でインストールしない
  • nvmで管理する場合はnvm経由でNode.jsを切り替える
  • PATHをむやみに削除しない
  • プロジェクトが必要とするNode.jsのバージョンを確認する
  • 設定変更後はターミナルを開き直す
  • エラーが出たら「nvm list」と「node –version」を確認する
  • 環境変数を変更する前に現在の設定を記録する

特に重要なのは、Node.jsを直接インストールする方法とnvm管理を無計画に混在させないことです。

危険性あり:nvmやNode.jsのフォルダーを直接削除しない

Node.jsが動かなくなると、nvmの管理フォルダーやNode.jsのフォルダーを手動で削除したくなることがあります。

しかし、直接削除するとnvmの管理情報と実際のファイルの状態が一致しなくなり、さらに問題が複雑になる可能性があります。

原因がわからない状態でnvmの管理フォルダーやPATHを大量に削除するのは避けてください。

まずnvmのコマンドで状態を確認し、それでも解決しない場合に再インストールを検討しましょう。

最終手段:nvmを再インストールする前に確認すること

どうしてもnvm自体が正常に動かない場合は、nvmの再インストールを検討します。

ただし、その前に次の情報を記録してください。

  • 「nvm list」で表示されるNode.jsのバージョン
  • 現在プロジェクトで使っているNode.jsのバージョン
  • 「where nvm」の結果
  • 「where node」の結果
  • WindowsのPATH設定

仕事で使っているパソコンの場合は、独自の開発環境や社内ツールがNode.jsに依存していることもあります。

その場合は、自己判断で削除せず、社内の担当者へ確認するほうが安全です。

Node.jsが動かないときのおすすめ確認順序

  1. 「nvm version」でnvmが動くか確認する
  2. 「node –version」でNode.jsを確認する
  3. 「npm –version」でnpmを確認する
  4. 「nvm list」でインストール済みのNode.jsを確認する
  5. 「nvm use」で使用するバージョンを選び直す
  6. Windows Terminalを開き直す
  7. 「where node」でNode.jsの場所を確認する
  8. 「where nvm」でnvmの場所を確認する
  9. PATHに古いNode.jsが残っていないか確認する
  10. 必要ならWindowsを再起動する
  11. それでも直らない場合にnvmの再インストールを検討する

この順番なら、大きな設定変更を行う前に原因を切り分けられます。

よくある質問

nvmは動くのにnodeが動きません

Node.jsがインストールされていないか、使用するバージョンが選択されていない可能性があります。「nvm list」で確認し、必要なバージョンを「nvm use」で選び直してください。

nvm useを実行してもnodeが認識されません

PATHやNode.jsへのリンク設定に問題がある可能性があります。まず「where node」と「where nvm」を実行して、Windowsがどの場所を認識しているか確認しましょう。

node –versionで古いバージョンが表示されます

nvmとは別にインストールされたNode.jsがPATHで優先されている可能性があります。「where node」で複数のNode.jsが見つからないか確認してください。

npmだけ動かないのはなぜですか?

現在選択されているNode.js環境に問題がある可能性があります。「nvm list」「node –version」「npm –version」の順番で確認してください。

nvmを再インストールすれば必ず直りますか?

必ず直るとは限りません。原因がPATHの競合や古いNode.jsの残存であれば、nvmを再インストールしても同じ問題が起きることがあります。まず現在の設定を確認することが重要です。

Windows Terminalでは動くのにVS Codeでは動きません

VS Codeが古い環境変数を読み込んだままになっている可能性があります。ファイルを保存してVS Codeを完全に終了し、起動し直してから確認してください。

Node.jsを直接インストールしていてもnvmを使えますか?

環境によっては競合する可能性があります。nvmでバージョン管理する場合は、複数のNode.jsがPATHに混在していないか確認することが大切です。

nvmでどのNode.jsを使えばいいですか?

使用するプロジェクトが指定しているバージョンを優先してください。必ずしも一番新しいNode.jsが最適とは限りません。プロジェクトの説明や開発チームの指定を確認しましょう。

Windows 10でも同じ方法で確認できますか?

基本的な考え方は同じです。「nvm list」「node –version」「where node」などの確認方法はWindows 10でも利用できます。ただし、環境変数を開く画面の表示がWindows 11と多少異なる場合があります。

まとめ|Node.jsが動かないときはnvmを再設定して順番に確認しよう

nvmを使っているWindows環境でNode.jsが動かなくなった場合は、いきなりNode.jsやnvmを削除するのではなく、現在の状態を確認することが重要です。

まず「nvm version」でnvmが動くか確認し、「nvm list」でインストール済みのNode.jsを調べます。

必要なNode.jsが存在するなら、「nvm use」で使用するバージョンを選び直し、「node –version」と「npm –version」で動作確認しましょう。

それでも動かない場合は、「where node」「where nvm」を使って実際にWindowsが参照している場所を確認します。

特に、Node.jsを直接インストールした環境とnvmで管理する環境が混在している場合は、PATHの競合に注意してください。

nvm再設定の基本は「現在の状態を確認する → 使用するNode.jsを選ぶ → ターミナルを開き直す → PATHを確認する」という順番です。

この流れを覚えておけば、Node.jsのバージョン切り替えでトラブルが起きても、必要以上に環境を削除せず安全に復旧しやすくなります。

コメント

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