「npm installって、なんかよく見るけど何してるの?」 JavaScriptを学びはじめたばかりの頃、私もそう思ってました。
この記事では、初心者の方でもスッと理解できるように、npm
とは何か、npm install
が何をしているのかを、例やイメージも交えながらやさしく解説していきます。
npmってなに?
まず前提として、npm
とは Node.jsのパッケージ管理ツール のこと。
- Node.js:JavaScriptをブラウザ外(サーバーやローカル)で動かせる環境
- パッケージ:便利な機能をまとめたツール(=ライブラリ)
npmは、「このライブラリを使いたいです〜!」とお願いして、 そのコード一式をネットから自分の環境に引っぱってくる役割を持っています。
npm install
ってなに?
npm install
は、npmで**パッケージをインストール(=ダウンロード)**するコマンド。
たとえば、axiosというHTTP通信ライブラリを使いたいときは:
npm install axios
と打つと、node_modules
というフォルダにaxiosのファイル群が追加され、 自分のプロジェクトから使えるようになります。
よく出てくるオプション
npm install
(だけ)
package.json
に書かれている全パッケージを一括インストール。 初めてプロジェクトを開いたときは、まずこれを実行するのが基本。
npm install
npm install パッケージ名
(個別に追加)
npm install lodash
特定のパッケージだけを追加したいときに使います。
--save
(現在は省略可)
昔はこれでpackage.json
に追加指定してました。今は自動で追加されるので省略でOK。
--save-dev
開発時だけ使うツール(テスト系など)はこっちに振り分け:
npm install jest --save-dev
npm installしたら何が起きてる?
node_modules/
フォルダに対象パッケージをDLpackage.json
に依存情報を記録(または更新)package-lock.json
でバージョン固定・依存関係も管理
簡単に言えば、**「必要な道具箱を持ってきて、今後も同じ道具を使えるようにメモしておく」**イメージ。
よくあるエラーと対処法
エラー | 原因 | 対処法 |
---|---|---|
npm: command not found | Node.js/npm未インストール | Node.js公式から再インストール |
EACCES: permission denied | macOS/Linuxで権限不足 | sudo を使う、またはnvm使用 |
package-lock.jsonの競合 | Gitでのバージョン不整合 | 削除して再インストールする |
まとめ
npm
はNode.jsのライブラリ管理係npm install
で便利ツールをプロジェクトに追加できるpackage.json
で依存管理が自動化されている
最初は難しく見えますが、コマンド1つでライブラリが使えるのはとても強力! 最初の一歩として「npm install」は確実に覚えておきたいところです。
コメント