npm

`package.json` の作成を対話的に進め、name / version / description / entry point などを尋ねます。

-y すべて既定を承諾; --init.author 'Name <e@x>' 既定を上書き

妥当な既定値で `package.json` を即座に生成します(ディレクトリから `name`、`version` は 1.0.0)— 現代的な出発点です。

`package.json` にリストされたすべての依存関係をインストールし、`node_modules` と `package-lock.json` を更新します。`NODE_ENV=production` の場合は dev 依存関係をスキップします。

--save-exact / -E バージョンを完全固定; --legacy-peer-deps; --force; --no-audit; --prefer-offline

`package-lock.json` だけからクリーン インストールします。`npm install` より高速で、最初に `node_modules` を削除し、ロックファイルの変更を拒否します — CI で最適な選択です。

--omit=dev devDependencies をスキップ; --prefer-offline

ランタイム依存関係を追加します(既定は `dependencies`)。解決されたバージョンを `package-lock.json` に記録し、`package.json` に書き込みます。

<pkg>@<version-range>; --save-dev / -D; --save-exact / -E; --save-optional / -O; --save-prod / -P

特定のバージョン範囲(semver)をインストールします:完全一致 `1.2.3`、チルド `~1.2.3`、キャレット `^1.2.3`、`latest` / `next` / `beta` などのタグ。

`devDependencies` に追加します — ビルド / テスト時のみ必要なツール(TypeScript、Jest、ESLint、Prettier)。

パッケージをグローバルにインストールし、バイナリがすべてのプロジェクトの `PATH` 上で利用できるようにします(TypeScript、tsx、create-react-app、http-server)。

`node_modules` と `package.json` からパッケージを削除します。

-D devDependencies から削除; -g グローバルを削除; --save false マニフェスト編集をスキップ(稀)

`package.json` の semver 仕様で許可された範囲内ですべての依存関係をアップグレードし、それに応じて `package-lock.json` を更新します。

--save false マニフェスト書き込みをスキップ; --workspace ワークスペース内で更新

1 つのパッケージを現在の semver 範囲を満たす最新バージョンに更新します。

単一のパッケージを最新リリースにアップグレードします(semver 範囲をバイパスし、範囲を `^<new-version>` に書き換えます)。

`package.json` の `scripts` セクションで定義されたスクリプトを実行します。`npm test`、`npm start`、`npm stop`、`npm restart` は `npm run X` の短縮形です。

-- silent npm ログを抑制; --if-present 無くてもエラーにしない; -- <args> 残りの引数をスクリプトに転送

基盤のスクリプトに追加の CLI 引数を渡します。`--` 以降はすべてそのまま転送されます。

ローカルまたは `npx` キャッシュされたパッケージからコマンドを実行します。非推奨の `npx <command>` 直接呼び出しを置き換えます。

現在のプロジェクトの依存関係ツリー(トップレベル + 推移的)を出力します。パッケージの重複を見つけるのに便利です。

--all; --depth=N 深さを制限; --json JSON 出力; -g グローバルを一覧

インストール済みのバージョンがマニフェストの範囲が許可する最新バージョンより古いすべての依存関係のテーブルを表示します。

--long 詳細; --json JSON 出力

パッケージのレジストリ メタデータ(バージョン、dist-tag、依存関係、メンテナ、リポジトリ URL、readme 抜粋)を表示します。

versions; time; dist-tags; repository.url

スタンドアロンの `npm-shrinkwrap.json`(`package-lock.json` と同じ形式)を生成します。ロックファイルなしで配布されるアプリでも再現可能なインストールが必要な場合に使用します。

現在アクティブなレジストリ URL を出力します。既定は `https://registry.npmjs.org/` です。

npm をプライベート / キャッシュ レジストリ(GitHub Packages、Verdaccio、中国ミラー)に向けます。`~/.npmrc` またはプロジェクトの `.npmrc` に書き込みます。

構成されたレジストリに対して認証し、トークンを `~/.npmrc` に保存します。`npm publish` の前に必要です。

--registry=<url> 別のレジストリにログイン; --scope=<scope> トークンを制限

現在のパッケージを構成されたレジストリにアップロードします。`package.json` 内に `name`(通常は `version`、`repository` も)が必要で、公開権限を持つログイン ユーザーが必要です。

--access public|restricted (スコープ付きパッケージ); --dry-run; --tag <tag> dist-tag で配布

特定のバージョンをレジストリから削除します。**公開後 72 時間以内は強く非推奨** — npm はサポートしますが推奨しません。

npm がインストール時に表示するメッセージと共に、バージョンを非推奨としてマークします。履歴を削除せずにユーザーを修正に誘導する正しい方法です。

インストール済みの依存関係ツリーに対してセキュリティ監査を実行し、npm レジストリからアドバイザリを取得します。

--json; --omit=dev dev 依存関係をスキップ; --audit-level=low|moderate|high|critical

アドバイザリを解決する最も近い非破壊バージョンにパッケージを自動アップグレードします。semver-major のジャンプを受け入れる場合のみ `npm audit fix --force` を使用してください。

--force; --dry-run

グローバル npm キャッシュ(POSIX では `~/.npm`)を消去します。レジストリを切り替えた後や奇妙なインストール エラーを追跡するときに使用します。

キャッシュされた tarball の整合性を削除せずに検証します。いつでも安全に実行できます。

monorepo(`package.json` の `workspaces` で定義)内の指定された単一のワークスペースにパッケージをインストールします。

monorepo のすべてのワークスペースでスクリプトを実行します。`-w <name>` は単一のワークスペースのみを実行します。

--if-present 無くてもエラーにしない

環境診断(Node バージョン、レジストリの到達可能性、キャッシュの健全性、Git の存在)を実行します — トラブルシューティング時に便利です。

現在のプロジェクトの直接依存関係のファンディング リンクを表示します(メンテナが OSS をスポンサーするために使用)。

エディタを開かずに CLI から `package.json` 内のフィールドを変更します。スクリプト / フックで便利です。