はじめに：npmとは何か？

npm（Node Package Manager）は、Node.jsの公式パッケージマネージャーとして、単なる依存関係の管理を超えた多機能ツールです。フロントエンドやNode.js開発において、依存ライブラリのインストール、プロジェクトのビルド、スクリプトの実行、そして自作パッケージの公開まで、開発の全工程を支える中心的な役割を担っています。このガイドは「基礎→応用→実践→トラブルシューティング」の流れに沿って、90%の開発シーンで役立つ実用的なテクニックを網羅し、初心者から上級者まで幅広く活用できるリファレンスとして設計されています。

npmの基本概念

• 依存関係の管理：Vue、React、Expressなどのオープンソースライブラリをインストール、アンインストール、更新します。
• プロジェクトのエンジニアリング：package.jsonファイルを通じて、プロジェクトの設定、依存関係、スクリプトなどを管理します。
• パッケージの公開：自作のコードをnpmパッケージとして公開し、世界中の開発者に利用してもらえます。
• 巨大なエコシステム：200万以上のパッケージを擁する世界最大のオープンソースエコシステムで、フロントエンド、バックエンド、ツールなどあらゆる分野をカバーしています。

環境のセットアップと構成

npmはNode.jsに同梱されているため、個別にインストールする必要はありません。

1. Node.jsのインストール（Windows/Linux/Mac対応）

Node.js公式サイトから最新のLTS（長期サポート）バージョン（例：20.x）をダウンロードしてください。インストール後、ターミナルまたはコマンドプロンプトを開き、以下のコマンドを実行してバージョンを確認します。正常にインストールされていればバージョン番号が表示されます。

node -v  # Node.jsのバージョンを確認（14.x以上、16.x+が推奨）
npm -v   # npmのバージョンを確認（通常8.x以上）

2. 核心設定：ミラーサイトの切り替え（国内ユーザー必須）

npmのデフォルトのミラーサイトは海外にあり、ダウンロード速度が遅かったり、失敗しやすい場合があります。国内の高速ミラーサイトに切り替えることを強く推奨します。

# 方式1：一時的にミラーサイトを指定してインストール（単回のインストールに有効）
npm install ライブラリ名 --registry=https://registry.npmmirror.com

# 方式2：グローバルにミラーサイトを設定（永続的に有効、推奨）
npm config set registry https://registry.npmmirror.com

# 設定が反映されたか確認
npm config get registry  # https://registry.npmmirror.comと表示されれば成功

# 公式ミラーサイトに戻す場合
npm config set registry https://registry.npmjs.org

3. 便利ツール：nrm（ミラーサイト管理ツール）

頻繁にミラーサイトを切り替える場合は、nrmという便利なツールをインストールすることをお勧めします。

# nrmをグローバルにインストール
npm install -g nrm

# 利用可能なミラーサイトの一覧を表示
nrm ls

# 淘宝ミラーサイトに切り替え
nrm use taobao

# ミラーサイトの速度をテスト
nrm test taobao

プロジェクトの初期化：package.jsonの作成

package.jsonは、プロジェクトの「顔」のような存在で、プロジェクト名、バージョン、依存関係、スクリプトなど、プロジェクトの核心情報を記録します。npmプロジェクトには必ず含める必要があります。

# 方式1：対話形式で作成（プロンプトに従って情報を入力、Enterキーでデフォルト値を使用）
npm init

# 方式2：即座に作成（デフォルト設定で自動生成、手動入力不要）
npm init -y  # または npm init --yes

生成されたpackage.jsonの主要な構造（簡略版）：

{
  "name": "my-app",         // プロジェクト名（小文字、スペースなし）
  "version": "1.0.0",       // バージョン番号（セマンティックバージョニング）
  "description": "",        // プロジェクトの説明
  "main": "index.js",       // エントリーファイル
  "scripts": {
    "test": "echo "Error: no test specified" && exit 1" // カスタムスクリプト（核心機能）
  },
  "dependencies": {
    // ここにプロジェクトが依存するライブラリが記述されます
  }
}