Skip to content

volta pin

Il comando volta pin aggiornerà il file package.json del progetto per usare le versioni selezionate degli strumenti. Ha la seguente sintassi:

bash
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`.

Notavolta pin si applica solo a Node e gestori di pacchetti (ad esempio npm o Yarn). Per le dipendenze, dovresti usare npm install o yarn add per aggiornare le versioni selezionate.

Esempi

Fissare Node.js

bash
# 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:

json
{
  "volta": {
    "node": "16.14.2"
  }
}

Fissare gestori di pacchetti

bash
# 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:

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:

  1. Se non hai ancora quello strumento, viene installato automaticamente
  2. La versione viene scritta nella sezione volta del package.json
  3. Chiunque lavori sul progetto usando Volta userà automaticamente la versione specificata
  4. 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:

json
{
  "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