ツール
npm
Node.js に標準同梱されるパッケージマネージャ兼公開レジストリ。package.json に依存を宣言し npm install で node_modules と package-lock.json を生成する。依存解決の衝突(ERESOLVE / peer 依存)、ロックファイルの差分、npm scripts、グローバルインストール時の権限など npm 固有の問題を扱い、ランタイム実行や nvm によるバージョン管理は Node.js 側が担当する。
バージョン移行
メジャーバージョンを上げたときに動かなくなることを、旧版と新版で同じコマンドを打ち比べて確かめた。
npm 11 → 12・変更点 10 つ
npm を 11 から 12 に上げると動かなくなること
問題一覧(10)
npm ci が package-lock.json と不一致で失敗する
npm ci は package.json と package-lock.json が完全に一致していることを前提とし、ズレると EUSAGE エラーで即停止する。手元で npm install を実行して lockfile を更新し commit するのが正攻法。
更新: 2026-10-20、タグ: npm-ci、package-lock、lockfile
npm install が「ERESOLVE unable to resolve dependency tree」で失敗する
ERESOLVE unable to resolve dependency tree は、peerDependencies の要求が食い違うと出る。衝突元を更新するのが本筋で、急ぐなら --legacy-peer-deps で回避する。
更新: 2026-10-20、タグ: eresolve、peer-dependency、dependency
npm install -g したコマンドが command not found で実行できない
グローバルインストール先の bin ディレクトリが PATH に入っていないのが典型原因。npm prefix -g で実際のインストール先を確認し、PATH に追加するか nvm 経由の構成に揃えると解決する。
更新: 2026-09-24、タグ: global-install、command-not-found、path
npm install が EACCES(permission denied)で失敗する
グローバル install で /usr/local や /usr/lib への書き込み権限が無いと EACCES になる。sudo に頼らず npm の prefix をユーザー領域に張り直すか、nvm / fnm で Node 自体を入れ直すのが安全策。
更新: 2026-08-31、タグ: permission、eacces、install
npm install が EINTEGRITY エラーでインストールできない
EINTEGRITY は取得した tarball のハッシュが package-lock.json の integrity と一致しないときのエラー。キャッシュ破損よりも lockfile 側の古いハッシュやプロキシによる改変が原因のことが多い。
更新: 2026-11-19、タグ: eintegrity、checksum、package-lock
npx が古いキャッシュ版を実行して最新バージョンにならない
npm 8 までの npx は一度実行したパッケージをキャッシュし、次回以降もキャッシュ版を使うため最新が反映されない。@latest を付けて実行すれば最新を取得できる。npm 9 以降は名前だけの実行でもレジストリの新しい版に入れ替わる。
更新: 2026-11-19、タグ: npx、cache、version
npm run で Missing script エラーが出てスクリプトを実行できない
npm run の Missing script は、引数なしの npm run で一覧を見てキー名を合わせれば直る。実行ディレクトリの違いも疑い、workspace の子パッケージなら -w で指定する。
更新: 2026-10-04、タグ: scripts、package-json、workspace
npm scripts で環境変数が設定できない(Windows で動かない)
"FOO=bar node app.js" の前置記法は POSIX シェル専用で、Windows 既定の cmd.exe では環境変数として解釈されない。cross-env で OS 差を吸収するか、script-shell の変更や Node.js の --env-file で対処する。
更新: 2026-10-15、タグ: scripts、env、windows
npm update でメジャーバージョンに更新できない
npm update は package.json に書かれた semver レンジ(^ や ~)の範囲内でしか更新しない仕様で、メジャーバージョンの壁は越えない。メジャー更新は npm install <pkg>@latest でレンジ自体を書き換える。
更新: 2026-10-22、タグ: npm-update、semver、package-json
npm「Fetching packages of type "git" have been disabled」の原因と直し方
npm の Fetching packages of type "git" have been disabled(EALLOWGIT)は、.npmrc に allow-git=root を書けば直る。npm 12 で allow-git の既定が none になり、git の依存を入れなくなった。
更新: 2026-11-17、タグ: npm12、allow-git、npmrc