安装依赖项

本指南将帮助您设置本地 Solana 开发环境。了解如何在 Windows (WSL)、Linux 和 Mac 上安装 Rust、Solana CLI 和 Anchor Framework。如果您希望单独安装每个依赖项,或者快速安装因某些原因失败,请使用本指南。

前置条件

安装 Rust

开发者使用 Rust 编程语言构建 Solana 程序。

  1. 使用 rustup 安装 Rust,在终端中输入以下命令:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

安装成功后,您将看到以下消息:

  1. 重新加载您的 PATH 环境变量,以包含 Cargo 的 bin 目录:
Terminal
$
. "$HOME/.cargo/env"
  1. 验证安装是否成功。
Terminal
$
rustc --version

您将看到类似以下的输出:

rustc 1.86.0 (05f9846f8 2025-03-31)

安装 Solana CLI

Solana CLI 提供了构建和部署 Solana 程序所需的所有工具。

  1. 使用官方安装命令安装 Solana CLI 工具套件:
Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

您可以将 stable 替换为与您所需版本匹配的软件版本标签(例如 v2.0.3),或者使用以下三个符号通道名称之一: stable、 beta 或 edge

  1. 添加 PATH 环境变量

首次安装 Solana CLI 时,可能会提示您添加一个 PATH 环境变量。为此,请关闭并重新打开终端,或在 shell 中运行以下命令:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
  1. 更新您的 PATH 环境变量

如果您使用的是 LinuxWSL,则必须将 Solana CLI 二进制文件添加到您的 PATH 中,以便在终端中可以使用该命令。请按照以下步骤操作:

a. 检查您正在使用的 shell 类型:

Terminal
$
echo $SHELL
  • 如果输出包含 /bash,请使用 .bashrc
  • 如果输出包含 /zsh,请使用 .zshrc

b. 根据您的 shell,运行相应的命令。

对于 Bash (bashrc):

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

对于 Zsh (zshrc):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc
$
source ~/.zshrc
  1. 重启您的终端或运行以下命令以刷新终端会话:
Terminal
$
source ~/.bashrc # If using Bash
$
source ~/.zshrc # If using Zsh
  1. 通过检查 Solana CLI 版本来验证安装是否成功:
Terminal
$
solana --version

您将看到如下输出:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

您可以在 Agave Github 仓库 查看所有可用版本。Agave 是 Anza 的验证器客户端,前身为 Solana Labs 验证器客户端。

  1. 根据需要将 Solana CLI 更新到最新版本 (可选)
Terminal
$
agave-install update

安装 Anchor CLI

Anchor 是一个用于开发 Solana 程序的框架。Anchor 框架利用 Rust 宏简化了编写 Solana 程序的过程。

前置条件

使用 anchor init 命令创建的默认 Anchor 项目测试文件(TypeScript)需要 Node.js 和 Yarn。(Rust 测试模板可通过 anchor init --test-template rust 使用。)

安装

您可以通过两种方式安装 Anchor CLI 和工具:

  • Anchor Version Manager (AVM) — 推荐的安装方法
  • 不使用 AVM — 直接从 GitHub 安装

Anchor 版本管理器 (AVM) 允许您在系统上安装和管理不同的 Anchor 版本,并在未来轻松更新 Anchor 版本。要使用 AVM 安装 Anchor,请按照以下步骤操作:

  1. 使用以下命令安装 AVM:
Terminal
$
cargo install --git https://github.com/solana-foundation/anchor avm --force
  1. 确认 AVM 是否成功安装:
Terminal
$
avm --version
  1. 使用 AVM 安装 Anchor CLI:

要安装最新版本:

Terminal
$
avm install latest
$
avm use latest

要安装特定版本,请指定版本号:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

在 Linux 或 WSL 上安装 Anchor CLI 时,您可能会遇到以下错误:

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

如果您看到此错误消息,请按照以下步骤操作:

  1. 安装本页面顶部 Linux 部分列出的依赖项。
  2. 重试安装 Anchor CLI。
  1. 验证安装是否成功,检查 Anchor CLI 的版本:
Terminal
$
anchor --version

您将看到类似以下的输出:

anchor-cli 0.31.1

别忘了运行 avm use 命令来声明系统上运行的 Anchor CLI 版本。

  • 如果您安装了 latest 版本,请运行 avm use latest
  • 如果您安装了 0.30.1 版本,请运行 avm use 0.30.1

为 Solana 开发设置 AI 工具

本节详细介绍了可选的 AI 工具设置,您可以使用这些工具加速 Solana 开发。

工具描述链接
MCPMCP 服务器,您可以通过光标连接以改进 Solana 的 AI 辅助开发。https://mcp.solana.com/
LLMs.txt优化的 LLM 文档,您可以使用它来训练 Solana 文档上的 LLM。https://solana.com/llms.txt

Is this page helpful?

Table of Contents

Edit Page