Installer les dépendances

Installez chaque dépendance séparément lorsque vous avez besoin d'une version spécifique ou lorsque l'installation rapide ne se termine pas correctement. Suivez les sections dans l'ordre pour un nouvel environnement, ou accédez directement à l'outil que vous devez installer ou dépanner.

Prérequis

Installer Rust

Les développeurs créent des programmes Solana en utilisant le langage de programmation Rust.

  1. Installez Rust en utilisant rustup en saisissant la commande suivante dans votre terminal :
Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Après une installation réussie, vous verrez le message suivant :

  1. Rechargez votre variable d'environnement PATH pour inclure le répertoire bin de Cargo :
Terminal
$
. "$HOME/.cargo/env"
  1. Vérifiez que l'installation a réussi.
Terminal
$
rustc --version

La commande affiche la version de Rust installée, par exemple :

rustc x.y.z (...)

Installer Solana CLI

Solana CLI fournit tous les outils nécessaires pour créer et déployer des programmes Solana.

  1. Installez la suite d'outils Solana CLI en utilisant la commande d'installation officielle :
Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Vous pouvez remplacer stable par une balise de version Agave spécifique ou par le canal de publication beta ou edge.

  1. Rendez Solana CLI disponible dans votre terminal actuel.

Le programme d'installation met à jour la configuration de votre shell et affiche la commande nécessaire pour mettre à jour la session en cours. La commande est généralement :

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

Si solana n'est toujours pas disponible, redémarrez votre terminal. Pour confirmer quel fichier de configuration du shell a été mis à jour par le programme d'installation, vérifiez votre shell actuel :

Terminal
$
echo $SHELL
  • Si la sortie contient /bash, redémarrez le terminal ou exécutez source ~/.bashrc.
  • Si la sortie contient /zsh, redémarrez le terminal ou exécutez source ~/.zshrc.
  1. Vérifiez que l'installation a réussi :
Terminal
$
solana --version

La commande affiche la version de Solana CLI installée, par exemple :

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

Vous pouvez consulter toutes les versions disponibles sur le dépôt GitHub d'Agave. Agave est le client validator d'Anza, anciennement connu sous le nom de client validator de Solana Labs.

  1. Pour mettre à jour Solana CLI ultérieurement, exécutez :
Terminal
$
agave-install update

Installer l'interface de ligne de commande Anchor

Anchor est un framework de développement de programmes Solana. Le framework Anchor exploite les macros Rust pour simplifier le processus d'écriture de programmes Solana.

Prérequis

Node.js et un gestionnaire de paquets JavaScript ne sont nécessaires que si vous sélectionnez un modèle de test TypeScript tel que Mocha ou Jest. Le modèle de test LiteSVM par défaut s'exécute en Rust et ne nécessite aucun outil Node.js.

Installation

Vous pouvez installer l'interface en ligne de commande (CLI) et les outils Anchor de deux manières :

  • Anchor Version Manager (AVM) — méthode d'installation recommandée
  • Sans AVM — installation directe depuis GitHub

Le gestionnaire de versions Anchor (AVM) vous permet d'installer et de gérer différentes versions d'Anchor sur votre système et de mettre à jour facilement les versions d'Anchor à l'avenir. Pour installer Anchor à l'aide d'AVM, suivez les étapes ci-dessous :

  1. Installez AVM avec la commande suivante :
Terminal
$
curl -sSfL https://raw.githubusercontent.com/otter-sec/anchor/master/avm/install | sh
  1. Confirmez qu'AVM s'est installé avec succès :
Terminal
$
avm --version
  1. Installez l'interface de ligne de commande Anchor à l'aide d'AVM :

Pour installer la dernière version :

Terminal
$
avm install latest
$
avm use latest

Pour installer une version spécifique, spécifiez le numéro de version :

Terminal
$
avm install 1.1.2
$
avm use 1.1.2

Lors de l'installation de l'Anchor CLI sur Linux ou WSL, vous pouvez rencontrer cette erreur :

error: could not exec the linker cc = note: Permission denied (os error 13)

Si vous voyez ce message d'erreur, suivez ces étapes :

  1. Installez les dépendances listées dans la section Linux en haut de cette page.
  2. Réessayez d'installer l'Anchor CLI.
  1. Vérifiez que l'installation a réussi en contrôlant la version de l'interface de ligne de commande Anchor :
Terminal
$
anchor --version

La commande affiche la version active de l'interface de ligne de commande Anchor, par exemple :

anchor-cli 1.1.2

Exécutez avm use pour sélectionner la version de l'interface de ligne de commande Anchor pour votre système.

  • Si vous avez installé la dernière version, exécutez avm use latest.
  • Si vous avez installé la version 1.1.2, exécutez avm use 1.1.2.

Installer le CLI Surfpool

Surfpool est un outil pour le développement local et un remplacement amélioré de solana-test-validator.

  1. Installez Surfpool avec la commande suivante :
Terminal
$
curl --proto '=https' --tlsv1.2 -sSfL https://run.surfpool.run/ | bash
  1. Vérifiez que l'installation a réussi en contrôlant la version du CLI Surfpool :
Terminal
$
surfpool --version

La commande affiche la version du CLI Surfpool installée, par exemple :

surfpool x.y.z

Is this page helpful?

Table des matières

Modifier la page
© 2026 Fondation Solana. Tous droits réservés.