Installare le dipendenze

Installa ogni dipendenza separatamente quando hai bisogno di una versione specifica o quando l'installazione rapida non viene completata correttamente. Segui le sezioni in ordine per un nuovo ambiente, oppure vai direttamente allo strumento che devi installare o di cui devi risolvere i problemi.

Prerequisiti

Installa Rust

Gli sviluppatori creano programmi Solana utilizzando il linguaggio di programmazione Rust.

  1. Installa Rust utilizzando rustup inserendo il seguente comando nel tuo terminale:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Dopo un'installazione riuscita vedrai il seguente messaggio:

  1. Ricarica la variabile d'ambiente PATH per includere la directory bin di Cargo:
Terminal
$
. "$HOME/.cargo/env"
  1. Verifica che l'installazione sia andata a buon fine.
Terminal
$
rustc --version

Il comando stampa la versione di Rust installata, ad esempio:

rustc x.y.z (...)

Installa Solana CLI

La Solana CLI fornisce tutti gli strumenti necessari per costruire e distribuire programmi Solana.

  1. Installa la suite di strumenti Solana CLI utilizzando il comando di installazione ufficiale:
Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Puoi sostituire stable con un tag di release specifico di Agave oppure con il canale di release beta o edge.

  1. Rendi disponibile la CLI di Solana nel terminale corrente.

Il programma di installazione aggiorna la configurazione della shell e stampa il comando necessario per aggiornare la sessione corrente. In genere il comando è:

Terminal
$
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"

Se solana risulta ancora non disponibile, riavvia il terminale. Per verificare quale file di configurazione della shell è stato aggiornato dal programma di installazione, controlla la shell corrente:

Terminal
$
echo $SHELL
  • Se l'output contiene /bash, riavvia il terminale oppure esegui source ~/.bashrc.
  • Se l'output contiene /zsh, riavvia il terminale oppure esegui source ~/.zshrc.
  1. Verifica che l'installazione sia riuscita:
Terminal
$
solana --version

Il comando stampa la versione installata della CLI di Solana, ad esempio:

solana-cli x.y.z (..., client:Agave)

Puoi vedere tutte le versioni disponibili nel repository GitHub di Agave. Agave è il client validator di Anza, precedentemente noto come client validator di Solana Labs.

  1. Per aggiornare la CLI di Solana in seguito, esegui:
Terminal
$
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

Node.js e un gestore di pacchetti JavaScript sono necessari solo quando selezioni un template di test TypeScript come Mocha o Jest. Il template di test LiteSVM predefinito viene eseguito in Rust e non richiede strumenti Node.js.

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:

  1. Installa AVM con il seguente comando:
Terminal
$
curl -sSfL https://raw.githubusercontent.com/otter-sec/anchor/master/avm/install | sh
  1. Conferma che AVM sia stato installato correttamente:
Terminal
$
avm --version
  1. Installa la CLI di Anchor utilizzando AVM:

Per installare l'ultima versione:

Terminal
$
avm install latest
$
avm use latest

Per installare una versione specifica, specifica il numero di versione:

Terminal
$
avm install 1.1.2
$
avm use 1.1.2

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 visualizzi questo messaggio di errore, segui i passaggi seguenti:

  1. Installa le dipendenze elencate nella sezione Linux in cima a questa pagina.
  2. Riprova a installare Anchor CLI.
  1. Verifica che l'installazione sia riuscita, controllando la versione della CLI di Anchor:
Terminal
$
anchor --version

Il comando stampa la versione attiva della CLI di Anchor, ad esempio:

anchor-cli 1.1.2

Esegui avm use per selezionare la versione della CLI di Anchor per il tuo sistema.

  • Se hai installato l'ultima versione, esegui avm use latest.
  • Se hai installato la versione 1.1.2, esegui avm use 1.1.2.

Installa Surfpool CLI

Surfpool è uno strumento per lo sviluppo locale e un sostituto migliorato di solana-test-validator.

  1. Installa Surfpool con il seguente comando:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSfL https://run.surfpool.run/ | bash
  1. Verifica che l'installazione sia riuscita controllando la versione di Surfpool CLI:
Terminal
$
surfpool --version

Il comando stampa la versione installata di Surfpool CLI, ad esempio:

surfpool x.y.z

Is this page helpful?

Indice dei contenuti

Modifica pagina
© 2026 Solana Foundation. Tutti i diritti riservati.