概要
npm と Yarn は、JavaScript / TypeScript プロジェクトの依存関係、スクリプト、ロックファイルを管理するためのパッケージマネージャーです。このチートシートでは、初期化、インストール、更新、監査、ワークスペース運用でよく使うコマンドを比較します。
最初に覚える最小セット
| 操作 | npm | yarn |
|---|
| 初期化 | npm init -y | yarn init -y |
| 依存を入れる | npm install | yarn |
| 追加 | npm install pkg | yarn add pkg |
| 開発依存 | npm install -D pkg | yarn add -D pkg |
| スクリプト | npm run build | yarn build |
| CI | npm ci | yarn install --frozen-lockfile |
| 脆弱性確認 | npm audit | yarn audit |
プロジェクトでは npm と Yarn を混在させず、ロックファイルを必ず Git にコミットします。package-lock.json と yarn.lock が同時にある場合は、チームで使うパッケージマネージャーを確認します。
初期化
| npm | yarn | 説明 |
|---|
npm init | yarn init | 対話形式で初期化 |
npm init -y | yarn init -y | デフォルト値で初期化 |
パッケージインストール
| npm | yarn | 説明 |
|---|
npm install | yarn | 依存関係をインストール |
npm install pkg | yarn add pkg | パッケージ追加 |
npm install -D pkg | yarn add -D pkg | 開発依存として追加 |
npm install -g pkg | yarn global add pkg | グローバルインストール |
npm install pkg@1.0.0 | yarn add pkg@1.0.0 | バージョン指定 |
npm install pkg@latest | yarn add pkg@latest | 最新版をインストール |
ポイント: -DフラグはdevDependenciesに追加。テストツールやビルドツールなど、本番不要なパッケージに使いましょう。
パッケージ削除
| npm | yarn | 説明 |
|---|
npm uninstall pkg | yarn remove pkg | パッケージ削除 |
npm uninstall -g pkg | yarn global remove pkg | グローバル削除 |
パッケージ更新
| npm | yarn | 説明 |
|---|
npm update | yarn upgrade | 全パッケージ更新 |
npm update pkg | yarn upgrade pkg | 特定パッケージ更新 |
npm outdated | yarn outdated | 更新可能なパッケージ表示 |
情報確認
| npm | yarn | 説明 |
|---|
npm list | yarn list | インストール済み一覧 |
npm list --depth=0 | yarn list --depth=0 | トップレベルのみ表示 |
npm info pkg | yarn info pkg | パッケージ情報 |
npm search keyword | - | パッケージ検索 |
npm view pkg versions | yarn info pkg versions | 利用可能バージョン |
実践メモ: npm outdatedで更新可能なパッケージを一覧表示。定期的にチェックしてセキュリティパッチを当てる習慣をつけましょう。
スクリプト実行
| npm | yarn | 説明 |
|---|
npm run script | yarn script | スクリプト実行 |
npm start | yarn start | start スクリプト実行 |
npm test | yarn test | test スクリプト実行 |
npm run build | yarn build | build スクリプト実行 |
npx pkg | yarn dlx pkg | 一時的に実行 |
キャッシュ
| npm | yarn | 説明 |
|---|
npm cache clean --force | yarn cache clean | キャッシュをクリア |
npm cache verify | - | キャッシュを検証 |
注意: npm install -g（グローバルインストール）はプロジェクト間で競合する可能性があります。npxで一時実行するか、プロジェクトローカルにインストールするのが推奨です。
ロックファイル
| npm | yarn | 説明 |
|---|
package-lock.json | yarn.lock | ロックファイル名 |
npm ci | yarn install --frozen-lockfile | ロックファイル厳密使用 |
ポイント: CI環境ではnpm ciを使いましょう。npm installと違い、ロックファイルと完全一致する依存をインストールするため、再現性が保証されます。
注意: package-lock.json（またはyarn.lock）は必ずGitにコミットしてください。ロックファイルなしではビルドの再現性が保証されません。
公開（Publishing）
| npm | yarn | 説明 |
|---|
npm login | yarn login | レジストリにログイン |
npm publish | yarn publish | パッケージ公開 |
npm unpublish pkg | - | パッケージ削除 |
npm version patch | yarn version --patch | パッチバージョンアップ |
npm version minor | yarn version --minor | マイナーバージョンアップ |
npm version major | yarn version --major | メジャーバージョンアップ |
設定
| npm | yarn | 説明 |
|---|
npm config list | yarn config list | 設定一覧 |
npm config set key value | yarn config set key value | 設定変更 |
npm config get key | yarn config get key | 設定取得 |
監査・セキュリティ
| npm | yarn | 説明 |
|---|
npm audit | yarn audit | 脆弱性チェック |
npm audit fix | - | 脆弱性自動修正 |
ワークスペース
| npm | yarn | 説明 |
|---|
npm init -w packages/a | - | ワークスペース初期化 |
npm install -w a pkg | yarn workspace a add pkg | 特定ワークスペースに追加 |
npm run -w a script | yarn workspace a script | 特定ワークスペースで実行 |
npm run --workspaces script | yarn workspaces run script | 全ワークスペースで実行 |
実践メモ: npm auditで脆弱性チェック。npm audit fixで自動修正可能なものは一括で対応できます。
注意: npm audit fix --force はメジャーバージョンを上げて破壊的変更を入れる可能性があります。実行前に差分とテスト範囲を確認してください。
よく使うコマンド組み合わせ
| コマンド | 説明 |
|---|
rm -rf node_modules && npm install | クリーンインストール |
npm list --depth=0 | grep pkg | パッケージ検索 |
npm ls pkg | パッケージの依存元を表示 |
npm explain pkg | 依存関係を詳細表示 |
npm dedupe | 重複パッケージを整理 |
npm prune | 不要パッケージを削除 |
注意: rm -rf node_modules は削除対象を間違えると復旧できません。実行前に pwd と ls でプロジェクト直下にいることを確認します。
まとめ
npm / Yarn では、依存追加、スクリプト実行、ロックファイル、CI インストール、脆弱性確認を押さえることが重要です。チーム内で使うパッケージマネージャーを統一し、ロックファイルを変更したときはテストまで実行します。
npm audit fix --force、グローバルインストール、rm -rf node_modules は影響が大きいため、差分と実行場所を確認してから使ってください。
参考リソース
← 一覧に戻る 
