Skip to content

volta pin

Der Befehl volta pin aktualisiert die package.json-Datei eines Projekts, um die ausgewählte Version eines Tools zu verwenden. Er hat die folgende Syntax:

bash
Heftet die Laufzeit oder den Paketmanager Ihres Projekts fest

USAGE:
    volta pin [FLAGS] <tool[@version]>...

FLAGS:
        --verbose    Aktiviert ausführliche Diagnose
        --quiet      Verhindert unnötige Ausgaben
    -h, --help       Druckt Hilfeinformationen

ARGS:
    <tool[@version]>...    Tools zum Festheften, wie `node@lts` oder `yarn@^1.14`.

Hinweisvolta pin funktioniert nur mit Node & Paketmanagern (z.B. npm oder Yarn). Für Abhängigkeiten sollten Sie npm install oder yarn add verwenden, um die ausgewählten Versionen zu aktualisieren.

Beispiele

Node.js festheften

bash
# Die neueste LTS-Version von Node festheften
volta pin node

# Eine spezifische Version von Node festheften
volta pin node@16.14.2

# Einen Node-Versionsbereich festheften
volta pin node@16

Wenn Sie eine Node.js-Version festheften, fügt Volta einen volta-Abschnitt zur package.json-Datei Ihres Projekts hinzu:

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

Paketmanager festheften

bash
# Die neueste npm-Version festheften
volta pin npm

# Eine spezifische Version von Yarn festheften
volta pin yarn@1.22.19

# pnpm festheften (wenn das Feature-Flag aktiviert ist)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0

Das Festheften von Paketmanagern fügt sie zum volta-Abschnitt in Ihrer package.json hinzu:

json
{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

Anwendungsfälle

Der Befehl volta pin ist wesentlich für:

  • Das Erstellen konsistenter Entwicklungsumgebungen in Ihrem Team
  • Das Sicherstellen, dass jeder, der an einem Projekt arbeitet, dieselbe Node.js-Version und denselben Paketmanager verwendet
  • Das Verhindern von "funktioniert auf meiner Maschine"-Problemen
  • Das Dokumentieren, mit welcher Node.js-Version Ihr Projekt kompatibel ist

Auswirkungen des Festheftens

Wenn Sie ein Tool festheften:

  1. Das Tool wird automatisch installiert, falls Sie es noch nicht haben
  2. Die Version wird in die package.json im volta-Abschnitt geschrieben
  3. Jeder mit Volta, der am Projekt arbeitet, wird automatisch die angegebene Version verwenden
  4. CI/CD-Systeme, die Volta verwenden, werden die korrekte Version verwenden

Festgeheftete Tools haben Vorrang vor Standard-Tool-Versionen, die mit volta install gesetzt wurden.

package.json Details

Der volta-Abschnitt in der package.json kann enthalten:

json
{
  "volta": {
    "node": "16.14.2",    // Exakte Version
    "npm": "^8.5.0",      // Semver-Bereich
    "yarn": "1.22.19",    // Exakte Version
    "pnpm": "7.0.0"       // Wenn pnpm-Unterstützung aktiviert ist
  }
}

Die Versionsspezifizierer können sein:

  • Exakte Versionen: 16.14.2
  • Hauptversionen: 16
  • Haupt.Neben-Versionen: 16.14
  • Semver-Bereiche: ^16.14.0
  • Tags: lts, latest