Ceeds Academy教材アプリ教材・症状語・タグで検索
索引グラフ試す
パッケージ管理▸npm

npm: パッケージ管理(package.json / install / scripts)

hands-on所要 25分最新草稿
前提: Node.js: 導入とバージョン管理(node / nvm)
意味グラフ(この教材と内容的に近い教材・1ネスト)
例え(Analogies)
npm=買い物リストと配達

package.jsonは「買い物リスト」、npm installは「リスト通り取り寄せてnode_modulesに収める配達」。lockファイルは「同じ商品を確実に再注文する型番控え」。

概要

📍 package-managers ▸ npm ▸ パッケージ管理 | 種別: hands-on | facts_as_of 2026-06(npm・Node 24同梱)

公式ドキュメント — hands-on

🎞 スライド

npm = Node の依存管理

宣言(package.json)→ 実体(node_modules)

3つのファイル/フォルダ(テキスト図)

package.json ─宣言─▶ どの依存・どのスクリプト
package-lock.json ─固定─▶ 版を固定(再現性)
node_modules ─実体─▶ ダウンロードされた中身(.gitignore)

install の流れ

package.json ──npm install──▶ node_modules
(lock があれば版どおりに再現)

—
出典(sources)

docs.npmjs.com ; Node 24 / 2026-06確認

確認問題(Review-Questions)
package-lock.json の役割は?択一
基礎公式
解答・解説▾ 開く

依存バージョンを固定し、別環境でも同じ依存を再現できるようにする。

node_modules はGit管理すべきか。理由も述べよ。記述
基礎公式
解答・解説▾ 開く

管理しない(.gitignore)。package.json/lockから再生成でき、巨大なため。

目次
例え概要公式ドキュメント出典確認問題
鮮度
最新
更新: 2026-06-15
次回棚卸し: 2026-12-15
周期: 6か月
版: npm(Node 24 同梱)

概要

npm は Node の依存管理ツール。package.json に依存とスクリプトを記述(宣言)し、node_modules に実体をインストールする。package-lock.json が版を固定して再現性を担保する。

公式ドキュメント準拠

npm init -y                # package.json を作成
npm install <pkg>          # 依存追加(dependencies)
npm install -D <pkg>       # 開発依存(devDependencies)
npm install                # package.json から一括導入
npm run <script>           # scripts を実行
npx <pkg>                  # 一時実行(インストールせず)
  • package.json=宣言、package-lock.json=版の固定(再現性)、node_modules=実体(.gitignore に入れる)。

出典: docs.npmjs.com

🧭 誤解訂正集

よくある誤解 正しい理解
node_modules も commit する .gitignore に入れる(実体は再生成できる)
install すれば毎回同じ版になる package-lock.json が無いと版がずれる
dependencies と devDependencies は同じ 実行用と開発専用(-D)で分ける

📖 用語

  • npm … Node 同梱の依存管理ツール。
  • package.json … 依存とスクリプトの宣言ファイル。
  • package-lock.json … 版を固定して再現性を保つファイル。
  • node_modules … ダウンロードされた依存の実体(.gitignore)。
  • scripts / npx … npm run で実行する定義 / 一時実行コマンド。

✅ 確認の目安(can-do)

package.json・package-lock.json・node_modules の役割を区別し、「何を commit して何を .gitignore するか・なぜ」(実体は再現できる/lock は版固定)を説明できる。

⚠️ エラー復旧集

症状 原因 復旧
node_modules が壊れた 不整合 node_modules を削除して npm install
lock と不一致 手動編集等 npm ci(CI向け・lock厳守)
node_modules を commit しそう .gitignore漏れ .gitignore に node_modules を追加