ツール
npm
Node.js に標準同梱されるパッケージマネージャ兼公開レジストリ。package.json に依存を宣言し npm install で node_modules と package-lock.json を生成する。依存解決の衝突（ERESOLVE / peer 依存）、ロックファイルの差分、npm scripts、グローバルインストール時の権限など npm 固有の問題を扱い、ランタイム実行や nvm によるバージョン管理は Node.js 側が担当する。
問題一覧（9）
npm ci が package-lock.json と不一致で失敗する
npm ci は package.json と package-lock.json が完全に一致していることを前提とし、ズレると EUSAGE エラーで即停止する。手元で npm install を実行して lockfile を更新し commit するのが正攻法。
更新: 2026-08-29、実行例あり、タグ: npm-ci、package-lock、lockfile
npm install が「ERESOLVE unable to resolve dependency tree」で失敗する
npm 7 以降は peerDependencies を厳格に解決するため、依存同士の要求バージョンが食い違うと ERESOLVE で停止する。原因の依存を更新するのが本筋で、暫定的には --legacy-peer-deps か overrides で回避する。
更新: 2026-08-31、実行例あり、タグ: 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-09-16、実行例あり、タグ: eintegrity、checksum、package-lock
npx が古いキャッシュ版を実行して最新バージョンにならない
npx は一度実行したパッケージをキャッシュし、次回以降はキャッシュ版を使うため最新が反映されない。@latest 指定や --prefer-online、--ignore-existing で最新を取得できる。
更新: 2026-07-25、タグ: npx、cache、version
npm run で Missing script エラーが出てスクリプトを実行できない
npm run xxx で Missing script エラーが出るのは、package.json の scripts にキーが無い、実行ディレクトリが違う、workspace の指定漏れの 3 系統。npm run を引数なしで実行し、現在の package.json の script 一覧を確認するのが最短。
更新: 2026-08-31、実行例あり、タグ: 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-08-27、タグ: scripts、env、windows
npm update でメジャーバージョンに更新できない
npm update は package.json に書かれた semver レンジ（^ や ~）の範囲内でしか更新しない仕様で、メジャーバージョンの壁は越えない。メジャー更新は npm install <pkg>@latest でレンジ自体を書き換える。
更新: 2026-07-07、タグ: npm-update、semver、package-json