環境構築
npm installが失敗する
パッケージのインストールでエラーが出る
こんな症状
npm installを実行するとエラーで止まる。Node.js環境のセットアップで起きやすいよ。
まず試す
node -v でバージョンを確認し最新LTSへ。node_modules と package-lock.json を消して npm install をやり直す。
env
# やり直し
rm -rf node_modules package-lock.json
npm install
# Nodeを最新LTSに（nvm利用時）
nvm install --lts && nvm use --ltsこれで直らなければ、下の「自分のケース」を確認。
🔍 自分のケースはどれ？
- ✓Nodeのバージョンが古い
→ nvm install --lts などで最新LTSに更新する。 - ✓途中で固まる/壊れた
→ node_modules と package-lock.json を消して再 install。 - ✓権限エラー（EACCES）
→ sudo は使わず、npm のグローバルディレクトリを自分の権限の場所に変える。
なぜ起きる？
Node.jsのバージョンが古い、ネットワークエラー、権限の問題、package.jsonの構文エラーなどが原因だよ。npmはpackage.jsonに書かれたパッケージをインターネットからダウンロードするから、ネットワーク接続やレジストリへのアクセスが必要なんだ。
✕ エラーが起きるコード
$ node --version
# 古いバージョン✓ 直したコード
$ nvm install --lts
$ nvm use --lts✅ 直ったか確認
npm install がエラーなく完了し、node_modules が作られればOK。
この解決法は役立ちましたか？
🔗 関連するエラー
- node_modules削除後にエラーが出る — node_modulesを削除したが再インストールしていない
- .gitignoreが効かない・無視されない — 追跡済みファイルには効かない／パターンの書き方ミス
- Permission denied — 権限が不足している
- VS Codeの拡張機能が動かない・反映されない — 再起動・有効化・追加設定のどれかが足りていない
- Live Serverが起動しない — Live Server 拡張機能が正しく動作していない
🔗 別カテゴリの関連エラー
📖 この問題を学べるレッスン
📝 関連ブログ記事
- プログラミングのエラーメッセージの読み方 — エラーの読み方を基礎から解説
- VS Codeのインストール方法 — インストールと初期設定を図解で解説
- プログラミング初心者が最初にやるべきこと5選 — 目的を決めて環境構築から