Eine Anleitung zum Einrichten Ihrer lokalen Solana-Entwicklungsumgebung. Erfahren Sie, wie Sie Rust, die Solana CLI und das Anchor Framework unter Windows (WSL), Linux und Mac installieren. Verwenden Sie diese Anleitung, wenn Sie jede Abhängigkeit einzeln installieren möchten oder wenn die Schnellinstallation aus irgendeinem Grund fehlschlägt.
Voraussetzungen
Rust installieren
Entwickler erstellen Solana-Programme mit der Programmiersprache Rust.
- Installieren Sie Rust mit rustup, indem Sie den folgenden Befehl in Ihrem Terminal eingeben:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Nach einer erfolgreichen Installation sehen Sie die folgende Meldung:
- Laden Sie Ihre PATH-Umgebungsvariable neu, um das bin-Verzeichnis von Cargo einzuschließen:
$. "$HOME/.cargo/env"
- Überprüfen Sie, ob die Installation erfolgreich war.
$rustc --version
Sie werden eine Ausgabe wie die folgende sehen:
rustc 1.86.0 (05f9846f8 2025-03-31)
Solana CLI installieren
Die Solana CLI bietet alle Tools, die zum Erstellen und Bereitstellen von Solana-Programmen erforderlich sind.
- Installieren Sie die Solana CLI Tool Suite mit dem offiziellen Installationsbefehl:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Sie können stable durch das Release-Tag ersetzen, das der Softwareversion
Ihres gewünschten Release entspricht (z. B. v2.0.3), oder einen der drei
symbolischen Kanalnamen verwenden: stable, beta oder edge.
- Fügen Sie eine PATH-Umgebungsvariable hinzu
Eine Erstinstallation der Solana CLI kann Sie auffordern, eine PATH
Umgebungsvariable hinzuzufügen. Schließen und öffnen Sie dazu Ihr Terminal
erneut oder führen Sie Folgendes in Ihrer Shell aus:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Aktualisieren Sie Ihre PATH-Umgebungsvariable
Wenn Sie Linux oder WSL verwenden, müssen Sie die Solana CLI-Binärdatei zu Ihrem PATH hinzufügen, damit der Befehl in Ihrem Terminal verfügbar ist. Befolgen Sie dazu die folgenden Schritte:
a. Überprüfen Sie, welche Shell Sie verwenden:
$echo $SHELL
- Wenn die Ausgabe
/bashenthält, verwenden Sie.bashrc. - Wenn die Ausgabe
/zshenthält, verwenden Sie.zshrc.
b. Führen Sie den entsprechenden Befehl basierend auf Ihrer Shell aus.
Für Bash (bashrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Für Zsh (zshrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Starten Sie Ihr Terminal neu oder führen Sie folgenden Befehl aus, um die Terminal-Sitzung zu aktualisieren:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Überprüfen Sie, ob die Installation erfolgreich war, indem Sie die Solana CLI-Version prüfen:
$solana --version
Sie werden eine Ausgabe wie die folgende sehen:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Sie können alle verfügbaren Versionen im Agave Github-Repository einsehen. Agave ist der Validatoren-Client von Anza, früher bekannt als Solana Labs Validatoren-Client.
- Aktualisieren Sie die Solana CLI bei Bedarf auf die neueste Version (Optional)
$agave-install update
Anchor CLI installieren
Anchor ist ein Framework zur Entwicklung von Solana-Programmen. Das Anchor-Framework nutzt Rust-Makros, um den Prozess des Schreibens von Solana-Programmen zu vereinfachen.
Voraussetzungen
Die Standard-Testdatei (TypeScript) des Anchor-Projekts, die mit dem Befehl
anchor init erstellt wird, erfordert Node.js und Yarn. (Die
Rust-Testvorlage ist mit anchor init --test-template rust verfügbar)
Installation
Sie können die Anchor-CLI und die Tools auf zwei Arten installieren:
- Anchor Version Manager (AVM) – empfohlene Installationsmethode
- Ohne AVM – direkt von GitHub installieren
Der Anchor Version Manager (AVM) ermöglicht es Ihnen, verschiedene Anchor-Versionen auf Ihrem System zu installieren und zu verwalten sowie Anchor-Versionen in Zukunft einfach zu aktualisieren. Um Anchor mit AVM zu installieren, folgen Sie den nachstehenden Schritten:
- Installieren Sie AVM mit folgendem Befehl:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Bestätigen Sie, dass AVM erfolgreich installiert wurde:
$avm --version
- Installieren Sie die Anchor CLI mit AVM:
Um die neueste Version zu installieren:
$avm install latest$avm use latest
Um eine bestimmte Version zu installieren, geben Sie die Versionsnummer an:
$avm install 0.30.1$avm use 0.30.1
Bei der Installation der Anchor CLI unter Linux oder WSL kann dieser Fehler auftreten:
error: could not exec the linker cc = note: Permission denied (os error 13)
Wenn Sie diese Fehlermeldung sehen, befolgen Sie diese Schritte:
- Installieren Sie die Abhängigkeiten, die im Abschnitt Linux am Anfang dieser Seite aufgeführt sind.
- Versuchen Sie erneut, die Anchor CLI zu installieren.
- Überprüfen Sie, ob die Installation erfolgreich war, indem Sie die Anchor CLI-Version kontrollieren:
$anchor --version
Sie werden eine Ausgabe wie die folgende sehen:
anchor-cli 0.31.1
Vergessen Sie nicht, den Befehl avm use auszuführen, um die Anchor
CLI-Version zu deklarieren, die auf Ihrem System ausgeführt werden soll.
- Wenn Sie die Version
latestinstalliert haben, führen Sieavm use latestaus. - Wenn Sie die Version
0.30.1installiert haben, führen Sieavm use 0.30.1aus.
Surfpool CLI installieren
Surfpool ist ein Tool für die lokale Entwicklung und
ein verbesserter Ersatz für solana-test-validator. Erfahren Sie mehr über die
Funktionen von Surfpool in der
Surfpool-Dokumentation.
- Installieren Sie Surfpool mit folgendem Befehl:
$curl -sL https://run.surfpool.run/ | bash
- Überprüfen Sie, ob die Installation erfolgreich war, indem Sie die Surfpool-CLI-Version prüfen:
$surfpool --version
Sie werden eine Ausgabe wie die folgende sehen:
surfpool 0.12.0
KI-Tools für die Solana-Entwicklung einrichten
Dieser Abschnitt beschreibt optionale KI-Tools, die Sie verwenden können, um Ihre Solana-Entwicklung zu beschleunigen.
| Tool | Beschreibung | Link |
|---|---|---|
| MCP | MCP-Server, mit dem Sie sich über Cursor verbinden können, um die KI-gestützte Solana-Entwicklung zu verbessern. | https://mcp.solana.com/ |
| LLMs.txt | Für LLMs optimierte Dokumentation, die Sie verwenden können, um LLMs mit der Solana-Dokumentation zu trainieren. | https://solana.com/llms.txt |
Is this page helpful?