Instalacja zależności
Przewodnik po konfiguracji lokalnego środowiska programistycznego Solana. Dowiedz się, jak zainstalować Rust, Solana CLI i Anchor Framework na Windows (WSL), Linuxie i Macu. Skorzystaj z tego przewodnika, jeśli wolisz instalować każdą zależność osobno lub jeśli szybka instalacja nie powiodła się z jakiegokolwiek powodu.
Wymagania wstępne
Instalacja Rust
Deweloperzy tworzą programy Solana, używając języka programowania Rust.
- Zainstaluj Rust za pomocą rustup, wpisując następujące polecenie w terminalu:
Terminal
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Po pomyślnej instalacji zobaczysz następujący komunikat:
- Załaduj ponownie zmienną środowiskową PATH, aby uwzględnić katalog bin Cargo:
Terminal
$. "$HOME/.cargo/env"
- Zweryfikuj, czy instalacja zakończyła się pomyślnie.
Terminal
$rustc --version
Zobaczysz wynik podobny do poniższego:
rustc 1.86.0 (05f9846f8 2025-03-31)
Instalacja Solana CLI
Solana CLI dostarcza wszystkie narzędzia potrzebne do tworzenia i wdrażania programów Solana.
- Zainstaluj zestaw narzędzi Solana CLI, używając oficjalnego polecenia instalacyjnego:
Terminal
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Możesz zastąpić stable tagiem wydania odpowiadającym wersji oprogramowania
Twojego pożądanego wydania (np. v2.0.3), lub użyć jednej z trzech
symbolicznych nazw kanałów: stable, beta, lub edge.
- Dodaj zmienną środowiskową PATH
Podczas pierwszej instalacji Solana CLI możesz zostać poproszony o dodanie
zmiennej środowiskowej PATH. Aby to zrobić, zamknij i ponownie otwórz terminal
lub uruchom następujące polecenie w swojej powłoce:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Zaktualizuj zmienną środowiskową PATH
Jeśli używasz Linuxa lub WSL, musisz dodać plik binarny Solana CLI do swojej zmiennej PATH, aby polecenie było dostępne w terminalu. Aby to zrobić, wykonaj poniższe kroki:
a. Sprawdź, której powłoki używasz:
Terminal
$echo $SHELL
- Jeśli wynik zawiera
/bash, użyj.bashrc. - Jeśli wynik zawiera
/zsh, użyj.zshrc.
b. Uruchom odpowiednie polecenie w zależności od używanej powłoki.
Dla Bash (bashrc):
Terminal
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Dla Zsh (zshrc):
Terminal
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Uruchom ponownie terminal lub wykonaj następujące polecenie, aby odświeżyć sesję terminala:
Terminal
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Zweryfikuj, czy instalacja zakończyła się sukcesem, sprawdzając wersję Solana CLI:
Terminal
$solana --version
Zobaczysz wynik podobny do poniższego:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Możesz zobaczyć wszystkie dostępne wersje w repozytorium Agave na Githubie. Agave to klient walidatora od Anza, wcześniej znany jako klient walidatora Solana Labs.
- Zaktualizuj Solana CLI do najnowszej wersji, jeśli to konieczne (Opcjonalne)
Terminal
$agave-install update
Zainstaluj Anchor CLI
Anchor to framework do tworzenia programów na platformie Solana. Framework Anchor wykorzystuje makra języka Rust, aby uprościć proces pisania programów na Solanę.
Wymagania wstępne
Domyślny plik testowy projektu Anchor (TypeScript) utworzony za pomocą polecenia
anchor init wymaga Node.js i Yarn. (Szablon testowy w języku Rust jest
dostępny za pomocą anchor init --test-template rust)
Instalacja
Możesz zainstalować Anchor CLI i narzędzia na dwa sposoby:
- Anchor Version Manager (AVM) — zalecana metoda instalacji
- Bez AVM — instalacja bezpośrednio z GitHuba
Anchor Version Manager (AVM) umożliwia instalację i zarządzanie różnymi wersjami Anchor na Twoim systemie oraz łatwą aktualizację wersji Anchor w przyszłości. Aby zainstalować Anchor za pomocą AVM, wykonaj poniższe kroki:
- Zainstaluj AVM za pomocą następującego polecenia:
Terminal
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Potwierdź, że AVM został pomyślnie zainstalowany:
Terminal
$avm --version
- Zainstaluj Anchor CLI za pomocą AVM:
Aby zainstalować najnowszą wersję:
Terminal
$avm install latest$avm use latest
Aby zainstalować konkretną wersję, podaj numer wersji:
Terminal
$avm install 0.30.1$avm use 0.30.1
Podczas instalacji Anchor CLI na Linuxie lub WSL możesz napotkać ten błąd:
error: could not exec the linker cc = note: Permission denied (os error 13)
Jeśli zobaczysz ten komunikat o błędzie, wykonaj następujące kroki:
- Zainstaluj zależności wymienione w sekcji Linux na początku tej strony.
- Ponownie spróbuj zainstalować Anchor CLI.
- Zweryfikuj, czy instalacja zakończyła się sukcesem, sprawdzając wersję Anchor CLI:
Terminal
$anchor --version
Zobaczysz wynik podobny do poniższego:
anchor-cli 0.31.1
Nie zapomnij uruchomić polecenia avm use, aby zadeklarować wersję
Anchor CLI uruchamianą na Twoim systemie.
- Jeśli zainstalowałeś wersję
latest, uruchomavm use latest. - Jeśli zainstalowałeś wersję
0.30.1, uruchomavm use 0.30.1.
Konfigurowanie narzędzi AI do rozwoju Solana
Ta sekcja opisuje opcjonalną konfigurację narzędzi AI, które możesz wykorzystać, aby przyspieszyć rozwój Solana.
| Narzędzie | Opis | Link |
|---|---|---|
| MCP | Serwer MCP, do którego możesz się podłączyć za pomocą kursora, aby usprawnić rozwój Solana wspomagany przez AI. | https://mcp.solana.com/ |
| LLMs.txt | Dokumentacja zoptymalizowana pod kątem LLM, którą możesz wykorzystać do trenowania LLM na dokumentacji Solana. | https://solana.com/llms.txt |
Is this page helpful?