Una guida per configurare il tuo ambiente di sviluppo Solana locale. Scopri come installare Rust, la CLI di Solana e Anchor Framework su Windows (WSL), Linux e Mac. Usa questa guida se preferisci installare ogni dipendenza individualmente, o se l'installazione rapida fallisce per qualsiasi motivo.
Prerequisiti
Installa Rust
Gli sviluppatori creano programmi Solana utilizzando il linguaggio di programmazione Rust.
- Installa Rust utilizzando rustup inserendo il seguente comando nel tuo terminale:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Dopo un'installazione riuscita vedrai il seguente messaggio:
- Ricarica la variabile d'ambiente PATH per includere la directory bin di Cargo:
$. "$HOME/.cargo/env"
- Verifica che l'installazione sia andata a buon fine.
$rustc --version
Vedrai un output simile al seguente:
rustc 1.86.0 (05f9846f8 2025-03-31)
Installa Solana CLI
La Solana CLI fornisce tutti gli strumenti necessari per costruire e distribuire programmi Solana.
- Installa la suite di strumenti Solana CLI utilizzando il comando di installazione ufficiale:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Puoi sostituire stable con il tag di release corrispondente alla versione
software della release desiderata (ad es. v2.0.3), oppure utilizzare uno dei
tre nomi di canale simbolici: stable, beta, o edge.
- Aggiungi una variabile d'ambiente PATH
Una prima installazione della Solana CLI potrebbe richiederti di aggiungere una
variabile d'ambiente PATH. Per farlo, chiudi e riapri il tuo terminale oppure
esegui il seguente comando nella tua shell:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Aggiorna la tua variabile d'ambiente PATH
Se stai utilizzando Linux o WSL, devi aggiungere il binario della Solana CLI al tuo PATH in modo che il comando sia disponibile nel tuo terminale. Per farlo, segui i passaggi seguenti:
a. Verifica quale shell stai utilizzando:
$echo $SHELL
- Se l'output contiene
/bash, usa.bashrc. - Se l'output contiene
/zsh, usa.zshrc.
b. Esegui il comando appropriato, in base alla tua shell.
Per Bash (bashrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Per Zsh (zshrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Riavvia il terminale o esegui il seguente comando per aggiornare la sessione del terminale:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Verifica che l'installazione sia riuscita controllando la versione della CLI di Solana:
$solana --version
Vedrai un output simile al seguente:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Puoi visualizzare tutte le versioni disponibili sul repository Github di Agave. Agave è il client validator di Anza, precedentemente noto come client validator di Solana Labs.
- Aggiorna la CLI di Solana all'ultima versione, se necessario (Opzionale)
$agave-install update
Installa la CLI di Anchor
Anchor è un framework per lo sviluppo di programmi Solana. Il framework Anchor sfrutta le macro Rust per semplificare il processo di scrittura dei programmi Solana.
Prerequisiti
Il file di test predefinito del progetto Anchor (TypeScript) creato con il
comando anchor init richiede Node.js e Yarn. (Il template di test Rust
è disponibile utilizzando anchor init --test-template rust)
Installazione
Puoi installare la CLI e gli strumenti di Anchor in due modi:
- Anchor Version Manager (AVM) — metodo di installazione consigliato
- Senza AVM — installa direttamente da GitHub
Anchor Version Manager (AVM) ti consente di installare e gestire diverse versioni di Anchor sul tuo sistema e di aggiornare facilmente le versioni di Anchor in futuro. Per installare Anchor utilizzando AVM, segui i passaggi seguenti:
- Installa AVM con il seguente comando:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Conferma che AVM sia stato installato correttamente:
$avm --version
- Installa la CLI di Anchor utilizzando AVM:
Per installare l'ultima versione:
$avm install latest$avm use latest
Per installare una versione specifica, specifica il numero di versione:
$avm install 0.30.1$avm use 0.30.1
Durante l'installazione della CLI di Anchor su Linux o WSL, potresti riscontrare questo errore:
error: could not exec the linker cc = note: Permission denied (os error 13)
Se visualizzi questo messaggio di errore, segui questi passaggi:
- Installa le dipendenze elencate nella sezione Linux nella parte superiore di questa pagina.
- Riprova a installare la CLI di Anchor.
- Verifica che l'installazione sia riuscita, controllando la versione della CLI di Anchor:
$anchor --version
Vedrai un output simile al seguente:
anchor-cli 0.31.1
Non dimenticare di eseguire il comando avm use per dichiarare la
versione della CLI di Anchor da eseguire sul tuo sistema.
- Se hai installato la versione
latest, eseguiavm use latest. - Se hai installato la versione
0.30.1, eseguiavm use 0.30.1.
Installa Surfpool CLI
Surfpool è uno strumento per lo sviluppo locale e un
sostituto migliorato di solana-test-validator. Scopri di più sulle
funzionalità di Surfpool nella
documentazione di Surfpool.
- Installa Surfpool con il seguente comando:
$curl -sL https://run.surfpool.run/ | bash
- Verifica che l'installazione sia riuscita controllando la versione di Surfpool CLI:
$surfpool --version
Vedrai un output simile al seguente:
surfpool 0.12.0
Configura gli strumenti AI per lo sviluppo su Solana
Questa sezione descrive la configurazione opzionale degli strumenti AI che puoi utilizzare per accelerare il tuo sviluppo su Solana.
| Strumento | Descrizione | Link |
|---|---|---|
| MCP | Server MCP a cui puoi connetterti con cursor per migliorare lo sviluppo assistito da AI su Solana. | https://mcp.solana.com/ |
| LLMs.txt | Documentazione ottimizzata per LLM che puoi utilizzare per addestrare gli LLM sulla documentazione di Solana. | https://solana.com/llms.txt |
Is this page helpful?