Un guide pour configurer votre environnement de développement Solana local. Apprenez à installer Rust, la CLI Solana et Anchor Framework sur Windows (WSL), Linux et Mac. Utilisez ce guide si vous préférez installer chaque dépendance individuellement, ou si l'installation rapide échoue pour une raison quelconque.
Prérequis
Installer Rust
Les développeurs créent des programmes Solana en utilisant le langage de programmation Rust.
- Installez Rust en utilisant rustup en saisissant la commande suivante dans votre 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 :
- Rechargez votre variable d'environnement PATH pour inclure le répertoire bin de Cargo :
$. "$HOME/.cargo/env"
- Vérifiez que l'installation a réussi.
$rustc --version
Vous verrez une sortie comme celle-ci :
rustc 1.86.0 (05f9846f8 2025-03-31)
Installer Solana CLI
Solana CLI fournit tous les outils nécessaires pour créer et déployer des programmes Solana.
- Installez la suite d'outils Solana CLI en utilisant la commande d'installation officielle :
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Vous pouvez remplacer stable par la balise de version correspondant à la
version logicielle de votre version souhaitée (par exemple v2.0.3), ou
utiliser l'un des trois noms de canaux symboliques : stable, beta, ou
edge.
- Ajoutez une variable d'environnement PATH
Une première installation de Solana CLI peut vous inviter à ajouter une variable
d'environnement PATH. Pour ce faire, fermez et rouvrez votre terminal ou
exécutez la commande suivante dans votre shell :
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Mettez à jour votre variable d'environnement PATH
Si vous utilisez Linux ou WSL, vous devez ajouter le binaire Solana CLI à votre PATH afin que la commande soit disponible dans votre terminal. Pour ce faire, suivez les étapes ci-dessous :
a. Vérifiez quel shell vous utilisez :
$echo $SHELL
- Si la sortie contient
/bash, utilisez.bashrc. - Si la sortie contient
/zsh, utilisez.zshrc.
b. Exécutez la commande appropriée en fonction de votre shell.
Pour Bash (bashrc) :
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Pour Zsh (zshrc) :
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Redémarrez votre terminal ou exécutez la commande suivante pour actualiser la session du terminal :
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Vérifiez que l'installation a réussi en vérifiant la version de l'interface de ligne de commande Solana :
$solana --version
Vous verrez une sortie comme celle-ci :
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, 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.
- Mettez à jour l'interface de ligne de commande Solana vers la dernière version, si nécessaire (Optionnel)
$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
Le fichier de test par défaut du projet Anchor (TypeScript) créé avec la
commande anchor init nécessite Node.js et Yarn. (Le modèle de test Rust
est disponible en utilisant anchor init --test-template rust)
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 :
- Installez AVM avec la commande suivante :
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Confirmez qu'AVM s'est installé avec succès :
$avm --version
- Installez l'interface de ligne de commande Anchor à l'aide d'AVM :
Pour installer la dernière version :
$avm install latest$avm use latest
Pour installer une version spécifique, spécifiez le numéro de version :
$avm install 0.30.1$avm use 0.30.1
Lors de l'installation de l'interface de ligne de commande Anchor 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 :
- Installez les dépendances listées dans la section Linux en haut de cette page.
- Réessayez d'installer l'interface de ligne de commande Anchor.
- Vérifiez que l'installation a réussi en contrôlant la version de l'interface de ligne de commande Anchor :
$anchor --version
Vous verrez une sortie comme celle-ci :
anchor-cli 0.31.1
N'oubliez pas d'exécuter la commande avm use pour déclarer la version
de l'interface de ligne de commande Anchor à exécuter sur votre système.
- Si vous avez installé la version
latest, exécutezavm use latest. - Si vous avez installé la version
0.30.1, exécutezavm use 0.30.1.
Installer le CLI Surfpool
Surfpool est un outil pour le développement local et un
remplacement amélioré de solana-test-validator. Découvrez les fonctionnalités
de Surfpool dans la documentation Surfpool.
- Installez Surfpool avec la commande suivante :
$curl -sL https://run.surfpool.run/ | bash
- Vérifiez que l'installation a réussi en contrôlant la version du CLI Surfpool :
$surfpool --version
Vous verrez une sortie comme celle-ci :
surfpool 0.12.0
Configurer les outils d'IA pour le développement Solana
Cette section détaille la configuration optionnelle des outils d'IA que vous pouvez utiliser pour accélérer votre développement Solana.
| Outil | Description | Lien |
|---|---|---|
| MCP | Serveur MCP auquel vous pouvez vous connecter avec cursor pour améliorer le développement Solana assisté par IA. | https://mcp.solana.com/ |
| LLMs.txt | Documentation optimisée pour les LLM que vous pouvez utiliser pour entraîner les LLM sur la documentation Solana. | https://solana.com/llms.txt |
Is this page helpful?