`npm version` în Node.js

npm și pachete Toate versiunile npm

Crește versiunea din package.json după regulile semver și, într-un depozit Git, face commit și etichetă vX.Y.Z.

Sintaxă

npm version <patch | minor | major | prerelease | versiune> [-m "mesaj %s"] [--no-git-tag-version]

Ce face `npm version`

npm version patch trece de la 1.0.0 la 1.0.1, minor la 1.1.0, major la 2.0.0. Comanda scrie noua versiune în package.json și în package-lock.json și o afișează.

Dacă proiectul este un depozit Git, face și un commit cu mesajul egal cu versiunea și o etichetă (tag) v1.0.1. Pentru asta, directorul de lucru trebuie să fie curat (fără modificări necomise). %s din mesajul dat cu -m se înlocuiește cu versiunea. --no-git-tag-version schimbă doar fișierele.

Fără argument, npm version afișează versiunile proiectului, ale lui npm, Node.js și ale bibliotecilor incluse în Node.js. Scripturile preversion, version și postversion din package.json rulează automat (de exemplu testele înainte).

Parametri

Parametru	Descriere
`patch / minor / major`	Ce parte din versiune crește.
`prerelease --preid=beta`	Versiune de test: `2.0.1-beta.0`, apoi `2.0.1-beta.1`.
`<versiune>`	O versiune exactă, de exemplu `2.0.0`.
`-m "mesaj %s"`	Mesajul commit-ului; `%s` devine versiunea.
`--no-git-tag-version`	Fără commit și fără etichetă Git.

Exemple

Exemplul 1: Trei versiuni noi, fiecare cu commit și etichetă

npm version patch
npm version minor
npm version major -m "Lansare %s"
git log --oneline
git tag

Ieșire în terminal

v1.0.1
v1.1.0
v2.0.0
3c9e1f2 Lansare 2.0.0
a81d0b7 1.1.0
5f2c6e4 1.0.1
9b04d13 Prima versiune
v1.0.1
v1.1.0
v2.0.0

Exemplul 2: Versiune beta și directorul nesalvat în Git

A doua comandă eșuează, pentru că există un fișier modificat și necomis.

npm version prerelease --preid=beta
echo "notițe" >> NOTE.md && git add NOTE.md
npm version patch

Ieșire în terminal

v2.0.1-beta.0
npm error Git working directory not clean.

Exemplul 3: Publicare tipică după versiune

Trimiți și etichetele pe server, apoi publici pachetul.

npm version minor
git push --follow-tags
npm publish

Greșeli frecvente

Schimbi versiunea de mână în package.json și uiți de lock și de eticheta Git. Lasă npm version să le facă împreună.
Faci git push fără --follow-tags: commit-ul ajunge pe server, eticheta v1.1.0 nu.
Alegi patch pentru o schimbare care strică codul celor care folosesc pachetul: după semver, schimbările incompatibile cer major.

Comenzi înrudite

Versiuni semver (^, ~, >=): Cum citește npm versiunile MAJOR.MINOR.PATCH și intervalele ^, ~, >=, x din package.json.
npm publish: Publică un pachet în registrul npm; cu npm pack –dry-run vezi înainte exact ce fișiere pleacă.
package.json: Fișierul de configurare al unui proiect Node.js: nume, versiune, tipul modulelor, scripturi, dependențe și versiunea Node cerută.
npm run: Rulează un script din câmpul „scripts” al package.json, cu node_modules/.bin în PATH și cu scripturile pre/post.

Ce face npm version