Przewodnik po konfiguracji lokalnego środowiska deweloperskiego Solana. Dowiedz się, jak zainstalować Rust, Solana CLI oraz Anchor Framework na Windows (WSL), Linuksie i Macu. Skorzystaj z tego przewodnika, jeśli wolisz instalować każdą zależność osobno lub jeśli szybka instalacja nie powiedzie się z jakiegoś powodu.
Wymagania wstępne
Instalacja Rust
Deweloperzy tworzą programy Solana w języku programowania Rust.
- Zainstaluj Rust za pomocą rustup, wpisując poniższe polecenie w terminalu:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Po pomyślnej instalacji zobaczysz następujący komunikat:
- Przeładuj zmienną środowiskową PATH, aby dodać katalog bin Cargo:
$. "$HOME/.cargo/env"
- Zweryfikuj, czy instalacja przebiegła pomyślnie.
$rustc --version
Zobaczysz wynik podobny do poniższego:
rustc 1.86.0 (05f9846f8 2025-03-31)
Instalacja Solana CLI
Solana CLI udostępnia wszystkie narzędzia potrzebne do budowania i wdrażania programów na Solanie.
- Zainstaluj pakiet narzędzi Solana CLI, używając oficjalnego polecenia instalacyjnego:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Możesz zastąpić stable tagiem wydania odpowiadającym wersji oprogramowania,
którą chcesz zainstalować (np. v2.0.3), lub użyć jednej z trzech
symbolicznych nazw kanałów: stable, beta lub edge.
- Dodaj zmienną środowiskową PATH
Przy pierwszej instalacji Solana CLI możesz zostać poproszony o dodanie zmiennej
środowiskowej PATH. Aby to zrobić, zamknij i ponownie otwórz terminal lub
uruchom poniższe polecenie w swojej powłoce:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Zaktualizuj zmienną środowiskową PATH
Jeśli korzystasz z Linuksa lub WSL, musisz dodać plik binarny Solana CLI do PATH, aby polecenie było dostępne w terminalu. W tym celu wykonaj poniższe kroki:
a. Sprawdź, z jakiej powłoki korzystasz:
$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):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Dla Zsh (zshrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Zrestartuj terminal lub uruchom poniższe polecenie, aby odświeżyć sesję terminala:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Zweryfikuj, czy instalacja się powiodła, sprawdzając wersję Solana CLI:
$solana --version
Zobaczysz wynik podobny do poniższego:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Wszystkie dostępne wersje możesz zobaczyć w repozytorium Agave Github. Agave to klient validatora od Anza, wcześniej znany jako klient validatora Solana Labs.
- Zaktualizuj Solana CLI do najnowszej wersji, jeśli to konieczne (opcjonalnie)
$agave-install update
Instalacja Anchor CLI
Anchor to framework do tworzenia programów na Solanie. Framework Anchor wykorzystuje makra 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 testu w Rust jest dostępny
przy użyciu 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 GitHub
Anchor Version Manager (AVM) umożliwia instalowanie 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:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Potwierdź, że AVM został poprawnie zainstalowany:
$avm --version
- Zainstaluj Anchor CLI używając AVM:
Aby zainstalować najnowszą wersję:
$avm install latest$avm use latest
Aby zainstalować konkretną wersję, podaj jej numer:
$avm install 0.30.1$avm use 0.30.1
Podczas instalacji Anchor CLI na Linuksie 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.
- Spróbuj ponownie zainstalować Anchor CLI.
- Zweryfikuj, czy instalacja zakończyła się sukcesem, sprawdzając wersję Anchor CLI:
$anchor --version
Zobaczysz wynik podobny do poniższego:
anchor-cli 0.31.1
Nie zapomnij uruchomić polecenia avm use, aby zadeklarować wersję
Anchor CLI, która ma być używana w Twoim systemie.
- Jeśli zainstalowałeś wersję
latest, uruchomavm use latest. - Jeśli zainstalowałeś wersję
0.30.1, uruchomavm use 0.30.1.
Instalacja Surfpool CLI
Surfpool to narzędzie do lokalnego developmentu i
ulepszony zamiennik dla solana-test-validator. Więcej o funkcjach Surfpool
znajdziesz w dokumentacji Surfpool.
- Zainstaluj Surfpool za pomocą poniższego polecenia:
$curl -sL https://run.surfpool.run/ | bash
- Zweryfikuj, czy instalacja zakończyła się sukcesem, sprawdzając wersję Surfpool CLI:
$surfpool --version
Zobaczysz wynik podobny do poniższego:
surfpool 0.12.0
Skonfiguruj narzędzia AI do developmentu na Solanie
Ta sekcja opisuje opcjonalną konfigurację narzędzi AI, które możesz wykorzystać do przyspieszenia developmentu na Solanie.
| Narzędzie | Opis | Link |
|---|---|---|
| MCP | Serwer MCP, do którego możesz się połączyć przez cursor, aby usprawnić development z AI na Solanie. | https://mcp.solana.com/ |
| LLMs.txt | Dokumentacja zoptymalizowana pod LLM, którą możesz wykorzystać do trenowania LLM na dokumentacji Solany. | https://solana.com/llms.txt |
Is this page helpful?