volta pin
Il comando volta pin
aggiornerà il file package.json
del progetto per usare le versioni selezionate degli strumenti. Ha la seguente sintassi:
Fissa il runtime o gestore di pacchetti del tuo progetto
Uso:
volta pin [FLAGS] <tool[@version]>...
Flag:
--verbose Abilita diagnostiche dettagliate
--quiet Previene output non necessari
-h, --help Stampa informazioni di aiuto
Argomenti:
<tool[@version]>... Strumento da fissare, come `node@lts` o `yarn@^1.14`.
Nota
volta pin
si applica solo a Node e gestori di pacchetti (ad esempio npm o Yarn). Per le dipendenze, dovresti usarenpm install
oyarn add
per aggiornare le versioni selezionate.
Esempi
Fissare Node.js
# Fissa l'ultima versione LTS di Node
volta pin node
# Fissa una versione specifica di Node
volta pin node@16.14.2
# Fissa un intervallo di versione di Node
volta pin node@16
Quando fissi una versione di Node.js, Volta aggiunge una sezione volta
nel file package.json
del progetto:
{
"volta": {
"node": "16.14.2"
}
}
Fissare gestori di pacchetti
# Fissa l'ultima versione di npm
volta pin npm
# Fissa una versione specifica di Yarn
volta pin yarn@1.22.19
# Fissa pnpm (se abilitato il flag di funzionalità)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0
Fissare i gestori di pacchetti li aggiunge alla sezione volta
nel package.json
:
{
"volta": {
"node": "16.14.2",
"npm": "8.5.0"
}
}
Casi d'uso
Il comando volta pin
è cruciale per:
- Creare ambienti di sviluppo coerenti nel tuo team
- Assicurare che tutti coloro che lavorano sul progetto usino le stesse versioni di Node.js e gestori di pacchetti
- Prevenire problemi "funziona sulla mia macchina"
- Documentare con quale versione di Node.js è compatibile il tuo progetto
Effetti del fissaggio
Quando fissi uno strumento:
- Se non hai ancora quello strumento, viene installato automaticamente
- La versione viene scritta nella sezione
volta
delpackage.json
- Chiunque lavori sul progetto usando Volta userà automaticamente la versione specificata
- I sistemi CI/CD che usano Volta useranno la versione corretta
Gli strumenti fissati hanno precedenza sulle versioni predefinite degli strumenti impostate con volta install
.
Dettagli package.json
La sezione volta
nel package.json
può includere:
{
"volta": {
"node": "16.14.2", // Versione esatta
"npm": "^8.5.0", // Intervallo Semver
"yarn": "1.22.19", // Versione esatta
"pnpm": "7.0.0" // Se abilitato il supporto pnpm
}
}
I specificatori di versione possono essere:
- Versione esatta:
16.14.2
- Versione principale:
16
- Versione principale.minore:
16.14
- Intervallo Semver:
^16.14.0
- Tag:
lts
,latest