tool
npm
Node.js に標準同梱されるパッケージマネージャ兼公開レジストリ。package.json に依存を宣言し npm install で node_modules と package-lock.json を生成する。依存解決の衝突(ERESOLVE / peer 依存)、ロックファイルの差分、npm scripts、グローバルインストール時の権限など npm 固有の問題を扱い、ランタイム実行や nvm によるバージョン管理は Node.js 側が担当する。
問題一覧(6)
npm ci が package-lock.json と不一致で失敗する
npm ci は package.json と package-lock.json が完全に一致していることを前提とし、ズレると EUSAGE エラーで即停止する。手元で npm install を実行して lockfile を更新し commit するのが正攻法。
更新: 2026-07-06、タグ: npm-ci、package-lock、lockfile
npm install -g したコマンドが command not found で実行できない
グローバルインストール先の bin ディレクトリが PATH に入っていないのが典型原因。npm prefix -g で実際のインストール先を確認し、PATH に追加するか nvm 経由の構成に揃えると解決する。
更新: 2026-07-05、タグ: global-install、command-not-found、path
npm install が EINTEGRITY エラーでインストールできない
EINTEGRITY は取得した tarball のハッシュが package-lock.json の integrity と一致しないときのエラー。キャッシュ破損よりも lockfile 側の古いハッシュやプロキシによる改変が原因のことが多い。
更新: 2026-06-29、タグ: eintegrity、checksum、package-lock
npx が古いキャッシュ版を実行して最新バージョンにならない
npx は一度実行したパッケージをキャッシュし、次回以降はキャッシュ版を使うため最新が反映されない。@latest 指定や --prefer-online、--ignore-existing で最新を取得できる。
更新: 2026-07-25、タグ: npx、cache、version
npm scripts で環境変数が設定できない(Windows で動かない)
"FOO=bar node app.js" の前置記法は POSIX シェル専用で、Windows 既定の cmd.exe では環境変数として解釈されない。cross-env で OS 差を吸収するか、script-shell の変更や Node.js の --env-file で対処する。
更新: 2026-06-11、タグ: scripts、env、windows
npm update でメジャーバージョンに更新できない
npm update は package.json に書かれた semver レンジ(^ や ~)の範囲内でしか更新しない仕様で、メジャーバージョンの壁は越えない。メジャー更新は npm install <pkg>@latest でレンジ自体を書き換える。
更新: 2026-07-07、タグ: npm-update、semver、package-json