Node.js のインストールと初期設定

Node.js とは、JavaScript をブラウザの外（サーバーやターミナル）で実行できるランタイム環境です。Web フロントエンド・バックエンド・CLI ツール・AI 連携アプリなど、幅広い用途で使われます。

このページでは、nvm を使った Node.js のインストールから、最初のプロジェクト作成までの手順を説明します。

対象読者: Node.js を初めてインストールする方

学習時間の目安: 読了 10分＋実践 15分

前提知識: ターミナルの基本操作（cd、ls など）

前提条件

ターミナルの基本操作ができること（ターミナル入門を参照）
Homebrew がインストールされていること（Homebrew のインストールを参照）
nvm がインストールされていること（nvm のインストールを参照）

なぜ nvm 経由で Node.js をインストールするのか

Node.js を公式インストーラーや Homebrew で直接インストールする方法もありますが、nvm 経由でインストールすることには以下のメリットがあります。

複数バージョンを共存できる — プロジェクトごとに異なる Node.js バージョンを使い分けられます
sudo なしで操作できる — アクセス権のエラーが起きにくく、グローバルパッケージの管理が安全です
バージョンを簡単に切り替えられる — nvm use <version> 1コマンドで切り替えられます

インストール手順

Step 1: Homebrew のインストール確認

Homebrew がインストールされていることを確認します。

brew --version
# 例: Homebrew 4.x.x

未インストールの場合は Homebrew のインストールを先に完了させてください。

Step 2: nvm のインストール確認

nvm がインストールされていることを確認します。

command -v nvm
# 「nvm」と表示されれば OK

未インストールの場合は nvm のインストールを先に完了させてください。

Step 3: Node.js のインストール

nvm を使って Node.js をインストールします。

nvm install --lts        # 最新の LTS 版をインストール
node -v                  # バージョン確認（例: v22.x.x）
npm -v                   # npm のバージョン確認（例: 10.x.x）

LTS（Long Term Support）版は安定性が高く、長期サポートが保証されています。新規プロジェクトには LTS 版を推奨します。

Step 4: npm を最新版にアップデート（任意）

Node.js と一緒にインストールされる npm も最新版にアップデートしておきます。

npm install -g npm
npm -v                   # アップデート後のバージョン確認

Step 5: 最初のプロジェクトを作成する

Node.js のインストールが完了したら、シンプルなプロジェクトを作成して動作を確認します。

mkdir my-first-project   # プロジェクトフォルダを作成
cd my-first-project      # フォルダに移動
npm init -y              # package.json を自動生成

npm init -y を実行すると、package.json というファイルが作成されます。このファイルはプロジェクトの情報や依存パッケージを管理するために使います。

ls                       # package.json が作成されていることを確認

インストール後の確認

次のコマンドを実行して、正常にインストールされているか確認します。

node -v     # 例: v22.x.x
npm -v      # 例: 10.x.x
nvm current # 現在使用中の Node.js バージョン

よくあるトラブルと解決策

Q: node: command not found と表示される

A: nvm が正しく設定されていない可能性があります。source ~/.zshrc（Zsh）または source ~/.bashrc（Bash）を実行してシェルを再読み込みしてください。それでも解決しない場合は nvm のインストールの手順を再確認してください。

Q: npm install 時に EACCES: permission denied エラーが出る

A: npm のグローバルインストール先にアクセス権がない状態です。nvm 経由でインストールした場合はこのエラーは起きないはずです。sudo を使わずに解決するには、nvm 経由のインストールに統一してください。

Q: package.json が見つからないというエラーが出る

A: 現在のフォルダに package.json がない状態でコマンドを実行しています。npm init -y で package.json を先に作成するか、プロジェクトフォルダに cd で移動してから再度コマンドを実行してください。

まとめ

Node.js は nvm 経由でインストールすることを推奨する
nvm install --lts で最新 LTS 版（2026年現在は v22 系）をインストールする
npm init -y でプロジェクトの package.json を作成する
node -v と npm -v でインストールを確認する