Laragon番外編5｜Node.js・npmを追加・切り替える｜バージョン確認とPowerShell対策

Laragonでは、PHPやMySQLだけでなく、Node.jsも複数のバージョンを追加して使い分けることができます。

前回のLaragon番外編4では、PHPを追加・切り替え、CLI (Command Line Interface)
とWebの両方から実際に使用されているPHPを確認するところまで進めました。

今回はJavaScript開発環境へ進みます。

Node.jsは、Next.jsやViteをはじめとするモダンなWeb開発でも利用されるJavaScript実行環境です。

Node.jsを使用するプロジェクトでは、バージョンによって利用できる機能やパッケージの対応状況が変わることがあります。

そのためLaragonでNode.jsを切り替える場合も、

追加する → 切り替える → 実際のNode.jsを確認する → npmを確認する → プロジェクトで確認する

ところまでを一連の作業として考えることが重要です。

この記事で確認すること

この記事では、Laragonで次の内容を確認します。

• Node.jsとnpmの役割
• LaragonでNode.jsを複数管理する仕組み
• Quick addからNode.jsを追加する方法
• Node.jsが保存される場所
• Quick addに目的のNode.jsがない場合
• 使用するNode.jsバージョンの切り替え
• 実際に参照されているNode.jsの確認
• npmの参照先とバージョン確認
• PowerShellでnpmが実行できない場合の切り分け
• Node.js切り替え後のプロジェクト確認
• npmのグローバルパッケージと保存先の確認
• 複数のNode.jsがPATHから参照される場合の確認
• 問題が発生した場合に元のNode.jsへ戻す方法

基本的な流れは、

Node.jsを追加 → 保存場所を確認 → 使用するバージョンへ切り替える →
Node.jsの参照先・バージョンを確認 → npmの参照先・バージョンを確認 →
プロジェクトで確認

です。

Node.jsとnpmの役割を整理する

最初に、Node.jsとnpmの違いを整理しておきます。

Node.jsとは

Node.jsは、JavaScriptをブラウザの外でも実行できるようにするJavaScript実行環境です。

Web制作では、Next.jsやViteを使った開発、ビルド処理、各種開発ツールの実行などでも
利用されます。

LaragonではNode.jsも複数バージョンを保持し、必要に応じて切り替えて使用できます。

npmとは

npmは、Node.jsを利用する開発環境でパッケージの管理やスクリプトの実行に使用するツールです。

たとえば、

npm install

npm run dev

npm run build

といったコマンドを実行するときに使用します。

Node.jsを切り替えたらnpmも確認する

Node.jsのWindows向け配布パッケージでは、通常npmも一緒に利用できる構成になっています。

そのためLaragonでNode.jsを切り替えたあとには、Node.jsだけではなく、
実際にどのnpmが参照されているかも確認します。

Node.jsのバージョンだけ正しくても、別の場所にあるnpmを参照していると、想定していた開発環境と異なる状態になる可能性があります。

LaragonでNode.jsを複数管理する仕組み

Laragonでは、Node.jsも他の実行環境と同様に複数バージョンを管理できます。

追加したNode.jsは、Laragon内のフォルダへバージョンごとに保存されます。

今回扱う環境では、Node.jsを次の階層で確認します。

C:\laragon\bin\nodejs\

バージョンごとのフォルダ内には、主に、

• node.exe
• npm
• npm.cmd
• npm関連ファイル

などが含まれています。

つまりLaragonでNode.jsを切り替えるときは、
複数用意されたNode.jsの中から現在使用する環境を選ぶと考えると理解しやすくなります。

Quick addからNode.jsを追加する

初めてNode.jsを追加する場合は、LaragonのQuick addを確認します。

Laragonで、

Menu → Tools → Quick add

を開きます。

一覧にNode.jsが表示されている場合は、追加したいバージョンを選択します。

ダウンロードと展開が完了すると、Laragonから利用できるNode.jsとして認識されます。

Quick addに目的のNode.jsがない場合

Quick addに追加したいNode.jsが表示されていない場合は、主に次の2つの方法があります。

• Node.jsのZIPファイルを取得して、Laragonへ手動で追加する
• Quick addの設定を確認し、必要に応じて取得先を追加・変更する

まずは、Quick addの設定ファイルを変更せずに利用できる手動追加から確認します。

Node.jsを手動で追加する

Quick addに目的のNode.jsがない場合は、Node.js公式サイトからWindows向けのZIPファイルを取得して、Laragonへ手動で追加できます。

1. Node.jsのZIPファイルをダウンロードする

Node.js公式サイトを開き、追加したいNode.jsバージョンのWindows用64-bit版、

win-x64.zip

をダウンロードします。

インストーラーではなく、Laragon内へ配置して使用できるZIP形式のファイルを使用します。

2. ZIPファイルを解凍してLaragonへ配置する

ダウンロードしたZIPファイルを解凍します。

展開されたフォルダは、

node-v20.x.x-win-x64

のような名前になっています。

このフォルダを、LaragonのNode.js保存先である、

C:\laragon\bin\nodejs\

へ配置します。

たとえば、Laragon側では次のような構成になります。

C:\laragon\bin\nodejs\node-vXX.XX.X\

フォルダ内に、

node.exe
npm
npm.cmd

などのNode.js・npm関連ファイルが含まれていることを確認してください。

3. Laragonから追加したNode.jsを確認する

配置が完了したらLaragonを再起動します。

その後、

Menu → Node.js → Version

を開き、手動で追加したNode.jsが一覧に表示されているか確認します。

表示されていれば、使用したいバージョンを選択します。

実際にそのNode.jsが使用されているかどうかは、このあとの「Node.jsのバージョンを切り替える」「実際に使用しているNode.jsを確認する」で確認します。

Quick addの取得先を確認する

Quick addに表示されるパッケージは、Laragon側の設定によって管理されています。

設定内容は、

Menu → Tools → Quick add → Configuration

から確認できます。

代表的な設定ファイルは、

C:\laragon\usr\packages.conf

です。

ここには、Node.jsを含むQuick add用パッケージの取得先が設定されています。

Quick addへ目的のNode.jsを追加したい場合は、設定されている取得先の仕組みを確認したうえで、実際に存在するNode.jsの配布パッケージとURLを指定します。

ただし、バージョン番号だけを安易に書き換えることはおすすめしません。

存在しないバージョンや誤ったURLを設定すると、Quick addから正常に取得できなくなる可能性があります。得できなくなる可能性があります。

Node.jsのバージョンを切り替える

複数のNode.jsが利用できる状態になったら、使用するバージョンを選択します。

Laragonで、

Menu → Node.js → Version

を開きます。

追加済みのNode.jsが表示されたら、使用したいバージョンを選択します。

選択したバージョンにチェックが付いていることを確認します。

切り替え後はTerminalを開き直す

Node.jsを切り替える前からTerminalを開いていた場合は、一度閉じて、Laragonから新しくTerminalを開き直す方法が分かりやすいです。

Laragonから開いたTerminalでは、Laragonの環境に合わせたPATHが利用されるため、
新しいTerminalで現在のNode.jsがどこを参照しているか確認します。

実際に使用しているNode.jsを確認する

Laragonのメニューで目的のNode.jsを選択したら、実際のCLI側でも確認します。

Node.jsの参照先を確認する

Laragon Terminalで、Node.jsの参照先を確認します。

where.exe node

where.exe node

結果に、

C:\laragon\bin\nodejs\...

C:\laragon\bin\nodejs\...

配下の node.exe が表示されているか確認します。
複数のNode.jsのパスが表示された場合は、後述する「複数のNode.jsが表示される場合」で、どのNode.jsが参照されているか確認します。

Node.jsのバージョンを確認する

続いて、現在のNode.jsバージョンを確認します。

node --version

node --version

Laragonで選択したNode.jsと同じバージョンが表示されていることを確認してください。

npmの参照先とバージョンを確認する

Node.jsが正しく切り替わったら、続いてnpmを確認します。

npmの参照先を確認する

次のコマンドを使用します。

where.exe npm

where.exe npm

Laragon側のNode.jsフォルダにあるnpm関連ファイルが参照されているか確認します。

npmのバージョンを確認する

次にnpmのバージョンを確認します。

npm --version

npm --version

正常にバージョン番号が表示されれば、CLIからnpmを実行できています。

PowerShellでnpmが実行できない場合

Windowsでは、Node.js自体が正常でも、PowerShellからnpmを実行した際にエラーになる場合があります。

代表的なのが、PowerShellの実行ポリシーによって npm.ps1 の実行が止められるケースです。

この場合、すぐにWindowsのセキュリティ設定を変更する必要はありません。

まず別の方法でnpm自体が正常に動いているか確認します。

まずLaragon Terminalまたはコマンドプロンプトで確認する

PowerShellでエラーになった場合は、Laragon Terminalやコマンドプロンプトからnpmを実行できるか確認します。

また、PowerShell上でもWindows用の npm.cmd を明示して確認できます。

npm.cmd --version

npm.cmd --version

これでバージョン番号が正常に表示されれば、Node.jsやnpmそのものではなく、PowerShell側の実行方法が原因である可能性を切り分けられます。

実行ポリシーの状態だけ確認する

PowerShell側の状態を確認したい場合は、現在の実行ポリシーを確認できます。

Get-ExecutionPolicy -List

Get-ExecutionPolicy -List

※このCODEは設定変更ではなく確認のみです。

Node.jsを切り替えたらプロジェクトでも確認する

Node.jsとnpmのCLI確認が終わったら、実際に使用するプロジェクトでも確認します。

Next.jsやViteなどのプロジェクトでは、package.json の scripts に、
開発サーバーの起動やビルドなどに使用するnpmスクリプトが定義されています。

まず、対象プロジェクトの package.json があるディレクトリへ移動し、利用できるスクリプトを確認します。
内容が分からないプロジェクトでは、npmスクリプトを実行する前に package.json の scripts に何が定義されているか確認してください。

npm run

npm run

たとえば build スクリプトが定義されているプロジェクトでは、

npm run build

npm run build

を実行して、切り替えたNode.js環境でもビルドできるか確認できます。

package.jsonのNode.js要件も確認する

プロジェクトによっては、package.json の engines などに、想定するNode.jsバージョンが記載されている場合があります。

新しいNode.jsへ切り替えたからといって、すべての既存プロジェクトがそのまま動作するとは限りません。

逆に、古いNode.jsへ戻した場合に、新しいパッケージやフレームワークが正常に動作しなくなることもあります。

そのため、実際に使用するプロジェクトで想定されているNode.jsバージョンを確認することが重要です。

※package.json の engines は、環境やnpmの設定によっては警告として扱われ、必ずしも実行を強制的に停止するとは限りません。利用しているフレームワークやパッケージ側の対応バージョンもあわせて確認してください。

グローバルパッケージの参照先にも注意する

Node.jsとnpmを切り替えたあと、必要に応じてnpmのグローバルパッケージも確認しておきます。

npmのグローバルパッケージは、npmに設定されているグローバルの保存先（prefix）を基準に管理されます。そのため、LaragonでNode.jsを切り替えたからといって、
グローバルパッケージが必ずNode.jsのバージョンごとに別になるわけではありません。

現在の環境でグローバルに認識されているパッケージは、次のコマンドで確認できます。

npm list -g --depth=0

npm list -g --depth=0

グローバルパッケージの保存先を確認したい場合は、次のコマンドを使用できます。

npm prefix -g

npm prefix -g

また、実際のグローバル node_modules の場所は、次のコマンドで確認できます。

npm root -g

npm root -g

Node.jsを切り替えたあとにグローバルツールが想定どおり動かない場合は、すぐに再インストールするのではなく、まずnpmがどの保存先を参照しているのか確認すると原因を切り分けやすくなります。

ただし、普段のプロジェクト開発では、可能な限りプロジェクト側に定義された依存関係を利用する方が、開発環境を再現しやすくなります。

Node.jsを切り替えてもバージョンが変わらない場合

LaragonでNode.jsを選んだのに、期待したバージョンが表示されない場合は、順番に原因を確認します。

1. Menu → Node.js → Version で選択中のバージョンを確認する
2. 開いているTerminalを閉じる
3. LaragonからTerminalを開き直す
4. where.exe node で参照先を確認する
5. node --version を確認する
6. where.exe npm を確認する
7. npm --version を確認する
8. Windows側に別のNode.jsが存在しないか確認する
9. PowerShellの場合は npm.cmd でも確認する
10. 実際のプロジェクトのNode.js要件を確認する

複数のNode.jsが表示される場合

where.exe node を実行したときに複数のパスが表示された場合は、Laragon以外のNode.jsもWindowsから参照できる状態になっている可能性があります。

たとえば、

• Laragon内のNode.js
• Windowsへ個別にインストールしたNode.js
• 別の開発環境が追加したNode.js

などが共存することがあります。

この場合は、where.exe node の結果を確認し、
実際にどのNode.jsが優先して参照されているのかを確認します。

問題が起きたら元のNode.jsへ戻す

Node.jsを切り替えたあとに、

• Next.jsが起動しない
• npmスクリプトが失敗する
• ビルドでエラーになる
• 使用しているパッケージが対応していない

といった問題が発生する場合があります。

その場合は、無理に新しいNode.jsのまま変更を続ける必要はありません。

Laragonで、

Menu → Node.js → Version

から、以前正常に使用していたNode.jsへ戻します。

その後、

Node.js → npm → プロジェクト

の順番でもう一度確認します。

Node.js・npm切り替え後の最終確認

最後に、Node.js・npm・実際のプロジェクトまで確認します。

• 使用したいNode.jsがLaragonへ追加されている
• Laragonで目的のNode.jsが選択されている
• Node.jsの参照先を確認できる
• node --version が目的のバージョンになっている
• npmの参照先を確認できる
• npm --version が正常に動作する
• PowerShellでnpmが実行できない場合に原因を切り分けられる
• プロジェクトのNode.js要件を確認している
• 必要なnpmスクリプトが正常に実行できる
• エラーや警告の有無を確認している
• 問題があれば以前のNode.jsへ戻せる

一通り問題がなければ、LaragonでのNode.js追加・バージョン切り替え・npm・プロジェクトの動作確認は完了です。

まとめ

Laragonでは、Node.jsも複数のバージョンを追加して使い分けることができます。

初学者の場合は、

Quick addでNode.jsを追加 → 使用するバージョンを選択 →
Node.jsを確認 → npmを確認 → プロジェクトで確認

という流れから覚えると分かりやすくなります。

特に重要なのは、メニューでNode.jsを選択しただけで終わらせず、

Node.jsの参照先 → Node.jsバージョン → npmの参照先・バージョン → プロジェクト

まで確認することです。

PowerShellでnpmが動かない場合も、すぐに実行ポリシーを変更するのではなく、Laragon Terminalやコマンドプロンプト、npm.cmd などから動作を切り分けると原因を整理しやすくなります。

Node.jsの切り替えは、単に新しいバージョンを使うためだけの機能ではありません。

プロジェクトごとの要件に合わせて必要なNode.jsを選び、問題があれば以前の環境へ戻して検証できることが、複数バージョンを管理する大きなメリットです。

前の記事

今回のLaragon番外編5では、Node.jsを追加・切り替え、npmや実際のプロジェクトまで確認する方法を整理しました。

1つ前のLaragon番外編4では、PHPを追加・切り替え、CLI・Web・php.ini・拡張機能・WordPressやLaravelで確認する流れを解説しています。

PHP側の複数バージョン管理を確認したい場合は、番外編4へ戻って確認できます。

PHPを追加・切り替え、CLI・Web・php.ini・拡張機能・WordPressやLaravelで確認

Laragon番外編4｜PHPを追加・切り替える｜php.ini・拡張機能・動作確認

Laragon番外編の流れへ戻る

Laragon番外編では、Webサーバー、データベース、PHP、Node.js、Python、Go、Rubyなど、ローカル開発環境を構成する各ツールや実行環境を順番に確認しています。

シリーズ全体の仕組みをもう一度確認したい場合は、Laragon番外編1へ戻って確認できます。

Laragon番外編1では、Laragonで複数バージョンを追加・切り替える基本的な仕組みを整理しています。

Apache、nginx、MySQL、PHP、Node.js、Python、Go、RubyなどをLaragonがどのように管理するのか確認したい場合は、シリーズの入口から見直してみてください。

複数バージョンを追加・切り替える基本的な仕組みを整理

Laragon番外編1｜複数バージョンを追加・切り替える仕組みを理解する

次に読む

Node.jsとnpmの環境を確認できたら、次はPythonの環境へ進みます。

Pythonでは、本体のバージョンだけではなく、pip によるパッケージ管理や、venv を使った仮想環境も重要になります。

LaragonへPythonを追加し、使用するバージョンを切り替えながら、pip・venvまで確認していきます。

LaragonでPythonを追加・切り替え、pipとvenvまで確認

Laragon番外編6｜Pythonを追加・切り替える｜pip・venv・Flask・VS Codeまで確認

toshi

フルスタックエンジニア

XFacebookInstagramContact

C型肝炎や感染症の闘病を経て現在通院中
フリーランスとして今日を生きる、それがすべて。
静かな光の中で、歩みを止めずに生きていく。
実験大好きなので色々とやっていきます。