Cheat sheet dei comandi npm

Cheat sheet dei comandi npm: install, ci, update, run, semver | We.Inc

Cerca tutti i comandi npm di tutti i giorni con i loro flag, scopri come npm ci differisce da npm install e prova qualsiasi range semver come ^1.2.3 o ~0.4 su una versione, nel tuo browser.

Cheat sheet dei comandi npm

I comandi npm che digiterai più spesso sono npm install per aggiungere pacchetti, npm ci per installazioni pulite in CI, npm update per spostarti all'interno dei tuoi range di versione, npm uninstall per rimuovere un pacchetto e npm run seguito dal nome di uno script. Cerca nella tabella completa qui sotto, poi verifica cosa consente un range con caret o tilde.

I cinque che ti servono subito

Gli elenchi di comandi online tendono a fermarsi al nome di ciascun comando. Questo aggiunge i flag che si usano davvero, gli alias, cosa scrive ogni comando in package.json e nel lockfile, e un tester dei range per vedere quali versioni accetta davvero un range con caret, tilde o x.

Domande frequenti

Qual è la differenza tra npm install e npm ci?

npm install risolve le versioni da package.json, può aggiornare il lockfile e mantiene la node_modules esistente. npm ci richiede un lockfile, cancella prima node_modules, installa esattamente ciò che il lockfile elenca, fallisce se non concorda con package.json e non scrive mai nessuno dei due file.

npm update modifica package.json?

Non per impostazione predefinita. La documentazione di npm indica save come false per npm update, quindi cambiano solo node_modules e il lockfile. Passa --save se vuoi che le nuove versioni vengano scritte in package.json.

Cosa significa il caret in ^1.2.3?

Consente qualsiasi modifica che lasci invariato il primo numero diverso da zero a sinistra. ^1.2.3 accetta le 1.x da 1.2.3 in su ma non la 2.0.0. Sotto la 1.0.0 è più restrittivo: ^0.2.3 accetta solo patch 0.2.x.

Come passo un flag allo script dietro npm run dev?

Metti -- prima del flag, per esempio npm run dev -- --port 4000. Tutto ciò che segue i due trattini va allo script invece di essere letto da npm.

Cosa significano Wanted e Latest in npm outdated?

Wanted è la versione più alta consentita dal range in package.json. Latest è la versione che l'autore del pacchetto ha etichettato come latest nel registry. Quando Latest è più alta di Wanted, per ottenerla devi modificare il range.

Install, ci e update fanno lavori diversi

Gli script sono scorciatoie con qualche regola

I range semver spiegati

In cosa si espande ogni range (regole node-semver, usate da npm)

Gli script di package.json

Un tipico blocco scripts

prebuild viene eseguito automaticamente prima di build. I binari locali come vite vengono risolti da node_modules/.bin.

Passaggio di installazione per la CI

Installazione pulita e ripetibile, una build, poi un controllo di sicurezza che fallisce solo con problemi gravi.

Configurazione

Crea un package.json con le risposte predefinite.

Installazione

Installa tutto ciò che è elencato in package.json. Tra gli alias ci sono npm i e npm add.

Installazione

Aggiunge un pacchetto a dependencies e al lockfile; il salvataggio è attivo per impostazione predefinita.

Installazione

Salva in devDependencies (forma lunga --save-dev).

Installazione

Salva una versione esatta invece di un range con caret (--save-exact).

Installazione

Salva in optionalDependencies (--save-optional).

Installazione

Installa senza registrarlo in package.json.

Installazione

Installa globalmente, nella cartella prefix di npm invece che nel progetto.

Installazione

Salta le devDependencies, per esempio su un server di produzione.

Installazione

Ignora i conflitti tra peer dependency come facevano le versioni più vecchie di npm.

Installazione

Installazione pulita dal lockfile: cancella node_modules, non scrive mai package.json né il lockfile. Alias npm clean-install.

Aggiornamento

Porta i pacchetti alle versioni più recenti consentite dai loro range. Alias up e upgrade.

Aggiornamento

Come sopra, e scrive le nuove versioni in package.json.

Aggiornamento

Aggiorna i pacchetti globali al loro tag latest.

Aggiornamento

Salta al tag latest anche oltre una versione major.

Aggiornamento

Mostra Current, Wanted e Latest per ogni dipendenza.

Rimozione

Rimuove un pacchetto e la sua voce in package.json e nel lockfile. Alias remove, rm, r, un e unlink.

Rimozione

Rimuove i file ma mantiene la voce in package.json.

Rimozione

Rimuove un pacchetto globale.

Script

Elenca tutti gli script di package.json.

Script

Esegue lo script dev, di solito un server di sviluppo.

Script

Passa i flag dopo -- allo script invece che a npm.

Script

Non fa nulla, senza fallire, quando lo script non esiste.

Script

Esegue lo script start; funziona anche per test, stop e restart senza run.

Script

Esegue pretest, test e posttest in ordine.

Script

Esegue il binario di un pacchetto senza installarlo globalmente.

Sicurezza

Chiede al registry le vulnerabilità note nel tuo albero delle dipendenze.

Sicurezza

Applica le correzioni che restano dentro i range dichiarati.

Sicurezza

Consente correzioni fuori dai tuoi range, comprese le versioni major. Controlla le modifiche.

Sicurezza

Esce con un errore solo per problemi high o critical, comodo in CI.

Ispezione

Mostra l'albero delle dipendenze installate.

Ispezione

Elenca le versioni pubblicate di un pacchetto.

Ispezione

Mostra la cartella in cui vengono installati i pacchetti globali.

Workspace

Esegue uno script in un solo workspace (--workspace=a).

Workspace

Esegue uno script in ogni workspace.

Cerca comandi npm

Cerca comandi

save, global, lock, script

Filtra per gruppo

Tutti

Comandi e flag npm

Comando

Gruppo

Cosa fa

{n} comandi mostrati

Nessun comando corrisponde a questa ricerca.

Copia

Tester dei range semver

Range

Versione

Il range {r} si espande in {e}, quindi la versione {v} lo soddisfa.

Il range {r} si espande in {e}, quindi la versione {v} non lo soddisfa.

Inserisci un range come ^1.2.3 e una versione completa come 1.4.0.

Inizia gratis · Nessuna carta di credito richiesta

Correlati: Guide

Prodotto

Per chi è

Funzionalità

Risorse

Azienda

Mappa del sito