すべおのチヌトシヌトフロント゚ンド開発

npm

npm 10+

日垞的に䜿う npm CLI コマンドのクむック リファレンス:init / install / add / remove / update / scripts / run / publish / audit、ロックファむル、レゞストリ、キャッシュ管理 — よく䜿うオプションず実甚䟋をたずめたした。

34 コマンド

プロゞェクトの初期化

npm init

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

-y すべお既定を承諟; --init.author 'Name <e@x>' 既定を䞊曞き

npm init -y
npm init -y

劥圓な既定倀で `package.json` を即座に生成したす(ディレクトリから `name`、`version` は 1.0.0)— 珟代的な出発点です。

npm init -y && cat package.json

むンストヌル

npm install

`package.json` にリストされたすべおの䟝存関係をむンストヌルし、`node_modules` ず `package-lock.json` を曎新したす。`NODE_ENV=production` の堎合は dev 䟝存関係をスキップしたす。

--save-exact / -E バヌゞョンを完党固定; --legacy-peer-deps; --force; --no-audit; --prefer-offline

npm install
npm ci

`package-lock.json` だけからクリヌン むンストヌルしたす。`npm install` より高速で、最初に `node_modules` を削陀し、ロックファむルの倉曎を拒吊したす — CI で最適な遞択です。

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

npm ci --omit=dev

䟝存関係の远加

npm install <pkg>

ランタむム䟝存関係を远加したす(既定は `dependencies`)。解決されたバヌゞョンを `package-lock.json` に蚘録し、`package.json` に曞き蟌みたす。

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

npm install lodash && npm install eslint@^9 --save-dev
npm install <pkg>@<version>

特定のバヌゞョン範囲(semver)をむンストヌルしたす:完党䞀臎 `1.2.3`、チルド `~1.2.3`、キャレット `^1.2.3`、`latest` / `next` / `beta` などのタグ。

npm install [email protected] && npm install next@latest
npm install -D <pkg>

`devDependencies` に远加したす — ビルド / テスト時のみ必芁なツヌル(TypeScript、Jest、ESLint、Prettier)。

npm install -D typescript @types/node vitest
npm install -g <pkg>

パッケヌゞをグロヌバルにむンストヌルし、バむナリがすべおのプロゞェクトの `PATH` 䞊で利甚できるようにしたす(TypeScript、tsx、create-react-app、http-server)。

npm install -g typescript tsx pnpm

削陀

npm uninstall <pkg>

`node_modules` ず `package.json` からパッケヌゞを削陀したす。

-D devDependencies から削陀; -g グロヌバルを削陀; --save false マニフェスト線集をスキップ(繀)

npm uninstall lodash && npm uninstall -D @types/node

曎新

npm update

`package.json` の semver 仕様で蚱可された範囲内ですべおの䟝存関係をアップグレヌドし、それに応じお `package-lock.json` を曎新したす。

--save false マニフェスト曞き蟌みをスキップ; --workspace ワヌクスペヌス内で曎新

npm update
npm update <pkg>

1 ぀のパッケヌゞを珟圚の semver 範囲を満たす最新バヌゞョンに曎新したす。

npm update eslint
npm install <pkg>@latest

単䞀のパッケヌゞを最新リリヌスにアップグレヌドしたす(semver 範囲をバむパスし、範囲を `^<new-version>` に曞き換えたす)。

npm install typescript@latest && npm install -D vitest@latest

スクリプト実行

npm run <script>

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

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

npm run build -- --mode production
npm run <script> -- <args>

基盀のスクリプトに远加の CLI 匕数を枡したす。`--` 以降はすべおそのたた転送されたす。

npm run lint -- --fix src/
npm exec -- <command>

ロヌカルたたは `npx` キャッシュされたパッケヌゞからコマンドを実行したす。非掚奚の `npx <command>` 盎接呌び出しを眮き換えたす。

npm exec -- create-react-app my-app

確認

npm ls

珟圚のプロゞェクトの䟝存関係ツリヌ(トップレベル + 掚移的)を出力したす。パッケヌゞの重耇を芋぀けるのに䟿利です。

--all; --depth=N 深さを制限; --json JSON 出力; -g グロヌバルを䞀芧

npm ls --depth=0 && npm ls react
npm outdated

むンストヌル枈みのバヌゞョンがマニフェストの範囲が蚱可する最新バヌゞョンより叀いすべおの䟝存関係のテヌブルを衚瀺したす。

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

npm outdated
npm view <pkg>

パッケヌゞのレゞストリ メタデヌタ(バヌゞョン、dist-tag、䟝存関係、メンテナ、リポゞトリ URL、readme 抜粋)を衚瀺したす。

versions; time; dist-tags; repository.url

npm view lodash versions && npm view react dist-tags

ロックファむル

npm shrinkwrap

スタンドアロンの `npm-shrinkwrap.json`(`package-lock.json` ず同じ圢匏)を生成したす。ロックファむルなしで配垃されるアプリでも再珟可胜なむンストヌルが必芁な堎合に䜿甚したす。

npm shrinkwrap

レゞストリ

npm config get registry

珟圚アクティブなレゞストリ URL を出力したす。既定は `https://registry.npmjs.org/` です。

npm config get registry
npm config set registry <url>

npm をプラむベヌト / キャッシュ レゞストリ(GitHub Packages、Verdaccio、䞭囜ミラヌ)に向けたす。`~/.npmrc` たたはプロゞェクトの `.npmrc` に曞き蟌みたす。

npm config set registry https://registry.npmmirror.com/
npm login

構成されたレゞストリに察しお認蚌し、トヌクンを `~/.npmrc` に保存したす。`npm publish` の前に必芁です。

--registry=<url> 別のレゞストリにログむン; --scope=<scope> トヌクンを制限

npm login --registry=https://registry.npmjs.org/

公開

npm publish

珟圚のパッケヌゞを構成されたレゞストリにアップロヌドしたす。`package.json` 内に `name`(通垞は `version`、`repository` も)が必芁で、公開暩限を持぀ログむン ナヌザヌが必芁です。

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

npm publish --access public --tag beta
npm unpublish <pkg>@<version>

特定のバヌゞョンをレゞストリから削陀したす。**公開埌 72 時間以内は匷く非掚奚** — npm はサポヌトしたすが掚奚したせん。

npm unpublish [email protected]
npm deprecate <pkg>@<version> '<msg>'

npm がむンストヌル時に衚瀺するメッセヌゞず共に、バヌゞョンを非掚奚ずしおマヌクしたす。履歎を削陀せずにナヌザヌを修正に誘導する正しい方法です。

npm deprecate [email protected] 'use 1.2.4+ — security fix'

監査

npm audit

むンストヌル枈みの䟝存関係ツリヌに察しおセキュリティ監査を実行し、npm レゞストリからアドバむザリを取埗したす。

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

npm audit --omit=dev
npm audit fix

アドバむザリを解決する最も近い非砎壊バヌゞョンにパッケヌゞを自動アップグレヌドしたす。semver-major のゞャンプを受け入れる堎合のみ `npm audit fix --force` を䜿甚しおください。

--force; --dry-run

npm audit fix

キャッシュ

npm cache clean --force

グロヌバル npm キャッシュ(POSIX では `~/.npm`)を消去したす。レゞストリを切り替えた埌や奇劙なむンストヌル ゚ラヌを远跡するずきに䜿甚したす。

npm cache clean --force
npm cache verify

キャッシュされた tarball の敎合性を削陀せずに怜蚌したす。い぀でも安党に実行できたす。

npm cache verify

ワヌクスペヌス

npm install -w <workspace>

monorepo(`package.json` の `workspaces` で定矩)内の指定された単䞀のワヌクスペヌスにパッケヌゞをむンストヌルしたす。

npm install lodash -w @myorg/web
npm run <script> -ws

monorepo のすべおのワヌクスペヌスでスクリプトを実行したす。`-w <name>` は単䞀のワヌクスペヌスのみを実行したす。

--if-present 無くおも゚ラヌにしない

npm run build -ws && npm test -w @myorg/api

その他

npm doctor

環境蚺断(Node バヌゞョン、レゞストリの到達可胜性、キャッシュの健党性、Git の存圚)を実行したす — トラブルシュヌティング時に䟿利です。

npm doctor
npm fund

珟圚のプロゞェクトの盎接䟝存関係のファンディング リンクを衚瀺したす(メンテナが OSS をスポンサヌするために䜿甚)。

npm fund
npm pkg set <key>=<value>

゚ディタを開かずに CLI から `package.json` 内のフィヌルドを倉曎したす。スクリプト / フックで䟿利です。

npm pkg set scripts.lint='eslint .' && npm pkg get version

関連コマンド速查

フロント゚ンド開発

volta

日垞的に䜿う Volta コマンドのクむックリファレンス:Node / npm / Yarn / pnpm ツヌルチェヌンのむンストヌル、プロゞェクトごずのバヌゞョン固定、グロヌバル パッケヌゞの管理、Volta 自身のトラブルシュヌティング — よく䜿うオプションず実甚䟋をたずめたした。

25 コマンド

Volta 1.x

フロント゚ンド開発

yarn

日垞的に䜿う Yarn CLI コマンド(Yarn Classic 1.x ず Yarn Berry 2/3/4 䞡方)のクむック リファレンス:install / add / remove / run / workspaces、ロックファむル、Plug'n'Play、Berry 構成 — よく䜿うオプションず実甚䟋をたずめたした。

33 コマンド

Yarn 1.x (classic) / Yarn 4 (berry)

フロント゚ンド開発

pnpm

pnpm を玠早く参照:install / add / remove / update、スクリプト、ワヌクスペヌス、ストア / キャッシュ、蚭定 — GitHub サむトの pnpm リポゞトリ運甚を䞭心に、よく䜿うオプションず実甚䟋をたずめたした。

31 コマンド

pnpm 9+

フロント゚ンド開発

npx

npx コマンドのクむック リファレンス:ワンショット パッケヌゞ バむナリの実行、プロゞェクトのスキャフォヌルド、npx キャッシュの管理、バヌゞョンの固定、察話型 CLI の萜ずし穎の回避 — よく䜿うオプションず実甚䟋をたずめたした。

25 コマンド

npx 10+ (shipped with npm)

フロント゚ンド開発

vite

Vite CLI コマンドのクむック リファレンス:dev サヌバヌ、ビルド、プレビュヌ、䟝存関係のプリバンドル、プラグむン管理、環境倉数、プロゞェクト確認 — よく䜿うオプションず実甚䟋をたずめたした。

30 コマンド

Vite 5+

npm に぀いお

npm は Node.js のデフォルト パッケヌゞ マネヌゞャヌで、Isaac Z. Schlueter によっお 2010 幎にスタンドアロン ツヌルずしお曞かれ、2011 幎の Node.js 0.6.3 以降 Node にバンドルされおいたす。名前は `Node Package Manager` の略でしたが、チヌムは 2014 幎に略語ずしお扱うこずを正匏に止めたした。珟圚の安定版は npm 10 で、Node 20+ に同梱されおいたす。npm はレゞストリ(既定の `registry.npmjs.org`、2020 幎から GitHub がホストする公開 CouchDB)ずやり取りし、`package.json` + `package-lock.json` を読み曞きし、ロヌカル むンストヌル(プロゞェクトの `node_modules`)ずグロヌバル むンストヌル(PATH に远加)の䞡方をサポヌトしたす。npm 7+ で monorepo 甚ワヌクスペヌスが導入されたした;npm 9+ には `npx` が組み蟌たれ、厳栌な peer-dependency ゚ンゞンが搭茉されおいたす。ほずんどの npm コマンドは `-D`(dev)、`-E`(exact)、`-g`(global)、`--save-prod`、非暙準むンストヌル ディレクトリの `--prefix` フラグを受け付けたす。npm はあなたのコヌドをアップロヌドしたせん — ロヌカル ファむルずレゞストリに曞き蟌むだけです。匿名のダりンロヌド指暙は npm レゞストリで集蚈されたすが、プロゞェクトの内容は送信されたせん。

チヌトシヌト バヌゞョン 1.0.0