Installare le dipendenze
Una guida per configurare il tuo ambiente di sviluppo locale Solana. Impara come installare Rust, la CLI di Solana e il framework Anchor 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 avvenuta con successo.
$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 sviluppare 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 rilascio corrispondente alla versione
del software che desideri (ad esempio v2.0.3
), o utilizzare uno dei tre nomi
simbolici dei canali: stable
, beta
, o edge
.
- Aggiungi una variabile d'ambiente PATH
La prima installazione della Solana CLI potrebbe chiederti di aggiungere una
variabile d'ambiente PATH
. Per farlo, chiudi e riapri il terminale o 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 affinché il comando sia disponibile nel tuo terminale. Per farlo, segui i passaggi seguenti:
a. Controlla 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 nel 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 Anchor CLI
Anchor è un framework per lo sviluppo di programmi Solana. Il framework Anchor sfrutta le macro di 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 modello di test Rust è
disponibile utilizzando anchor init --test-template rust
)
Installazione
Puoi installare la CLI di Anchor e gli strumenti in due modi:
- Anchor Version Manager (AVM) — Metodo di installazione consigliato
- Senza AVM — Installa direttamente da GitHub
L'Anchor Version Manager (AVM) ti permette di installare e gestire diverse versioni di Anchor sul tuo sistema e 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 Anchor CLI utilizzando AVM:
Per installare l'ultima versione:
$avm install latest$avm use latest
Per installare una versione specifica, indica il numero di versione:
$avm install 0.30.1$avm use 0.30.1
Durante l'installazione di Anchor CLI su Linux o WSL, potresti incontrare questo errore:
error: could not exec the linker cc = note: Permission denied (os error 13)
Se vedi questo messaggio di errore, segui questi passaggi:
- Installa le dipendenze elencate nella sezione Linux all'inizio di questa pagina.
- Riprova a installare Anchor CLI.
- Verifica che l'installazione sia riuscita, controllando la versione di Anchor CLI:
$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 di Anchor CLI 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
.
Configurazione degli strumenti AI per lo sviluppo su Solana
Questa sezione descrive la configurazione opzionale degli strumenti di intelligenza artificiale 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 i modelli LLM sulla documentazione di Solana. | https://solana.com/llms.txt |
Is this page helpful?