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.

  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 avvenuta con successo.
Terminal
$
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.

  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 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.

  1. 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"
  1. 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:

Terminal
$
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):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
$
source ~/.bashrc

Per Zsh (zshrc):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc
$
source ~/.zshrc
  1. Riavvia il terminale o esegui il seguente comando per aggiornare la sessione del terminale:
Terminal
$
source ~/.bashrc # If using Bash
$
source ~/.zshrc # If using Zsh
  1. Verifica che l'installazione sia riuscita controllando la versione della CLI di Solana:
Terminal
$
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.

  1. Aggiorna la CLI di Solana all'ultima versione, se necessario (Opzionale)
Terminal
$
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:

  1. Installa AVM con il seguente comando:
Terminal
$
cargo install --git https://github.com/solana-foundation/anchor avm --force
  1. Conferma che AVM sia stato installato correttamente:
Terminal
$
avm --version
  1. Installa Anchor CLI utilizzando AVM:

Per installare l'ultima versione:

Terminal
$
avm install latest
$
avm use latest

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

Terminal
$
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:

  1. Installa le dipendenze elencate nella sezione Linux all'inizio di questa pagina.
  2. Riprova a installare Anchor CLI.
  1. Verifica che l'installazione sia riuscita, controllando la versione di Anchor CLI:
Terminal
$
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, esegui avm use latest.
  • Se hai installato la versione 0.30.1, esegui avm 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.

StrumentoDescrizioneLink
MCPServer MCP a cui puoi connetterti con cursor per migliorare lo sviluppo assistito da AI su Solana.https://mcp.solana.com/
LLMs.txtDocumentazione ottimizzata per LLM che puoi utilizzare per addestrare i modelli LLM sulla documentazione di Solana.https://solana.com/llms.txt

Is this page helpful?

Indice

Modifica Pagina