【解決済み】「npm: コマンドが見つかりません」エラーの対処法（Linux・macOS・Windows対応）

NPM（Node Package Manager）は、JavaScriptのパッケージとその依存関係を管理するためのツールです。開発者の間で頻繁に利用される数多くのコードを提供しており、Windows、Linux、macOSといったすべての主要プラットフォームで広く使われています。

Linuxでは「command not found（コマンドが見つかりません）」というエラーが頻繁に発生します。主な原因は、システムに必要なコマンドが存在しないことです。「Command 'npm' not found」というエラーも同様で、Node Package Managerがインストールされていない状態で「npm」コマンドを使用しようとすると発生します。

この記事では、「Command 'npm' not found」エラーの考えられる原因と、OSごとの具体的な解決策について詳しく解説します。

なぜこのエラーが発生するのか？

前述のとおり、このエラーはターミナルからNPMコマンドを実行しようとした際に、システムにNPMがインストールされていない場合に発生します。エラーが表示されると、パッケージのインストールや管理など、Node.js関連の作業が一切行えなくなります。

解決策：NPMをインストールする

このエラーを修正する基本的な方法は、システムにNPMをインストールすることです。まずはLinuxでの手順を見ていきましょう。

ステップ1：LinuxにNPMをインストールする

お使いのLinuxディストリビューションに応じて、以下のいずれかのコマンドを実行してNPMをインストールします。

$ sudo apt install npm #Debian/Ubuntu系の場合
$ sudo yum install npm #RHEL/CentOS系の場合
$ sudo dnf install npm #Fedora系の場合
$ sudo pacman -S npm #Arch系の場合
$ sudo zypper install npm #OpenSUSE系の場合

ステップ2：解決を確認する

インストールが完了したら、以下のコマンドでエラーが解消されたことを確認します。

$ npm

バージョン情報やヘルプが表示されれば、エラーは正常に解決されています。

macOSでの対処法

macOSの場合、パッケージ管理ツール「Homebrew」を使えば、Node.jsとNPMを同時にインストールできます。

$ brew install node

Homebrewが未導入の場合は、Node.js公式サイトからmacOS用のインストーラー（.pkg）をダウンロードしてインストールする方法もあります。

Windowsでの対処法

Windowsの場合は、Node.js公式サイトからWindows用インストーラー（.msi）をダウンロードし、ウィザードの指示に従ってインストールします。インストール時に「npm package manager」にチェックが入っていることを確認してください。完了後、コマンドプロンプトまたはPowerShellで以下のコマンドを実行して動作を確認できます。

npm -v

LinuxでのNPMの基本的な使い方

NPMコマンドが正常に動作するようになると、ターミナルを使ってパッケージの検索、インストール、削除など、さまざまな操作が可能になります。よく使われるNPMコマンドを以下に紹介します。

パッケージを検索する場合：

$ npm search パッケージ名

パッケージをインストールする場合：

$ npm install パッケージ名

パッケージを削除する場合：

$ npm uninstall パッケージ名

インストール済みパッケージの一覧を表示する場合：

$ npm ls

まとめ

「Command 'npm' not found」エラーは、システムに「npm」がインストールされていないことが原因で発生します。NPMが存在しない状態では、Node.jsのパッケージ管理を行うことができません。このエラーを修正するには、お使いの環境（Debian系・RHEL系などのLinuxディストリビューション、macOS、Windows）に合わせた適切な方法でNPMをインストールしてください。本記事で紹介した手順に従えば、誰でも簡単にエラーを解消できます。