本指南将帮助你搭建本地 Solana 开发环境。你将学习如何在 Windows（WSL）、Linux 和 Mac 上分别安装 Rust、Solana CLI 以及 Anchor Framework。如果你希望单独安装每个依赖项，或者快速安装因某些原因失败，可以参考本指南。
前置条件
安装 Rust
开发者使用 Rust 编程语言开发 Solana 程序。
- 通过在终端中输入以下命令，使用 rustup 安装 Rust：
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
安装成功后，您将看到以下信息：
- 重新加载您的 PATH 环境变量，将 Cargo 的 bin 目录加入其中：
$. "$HOME/.cargo/env"
- 验证安装是否成功。
$rustc --version
您将看到类似如下的输出：
rustc 1.86.0 (05f9846f8 2025-03-31)
安装 Solana CLI
Solana CLI 提供了构建和部署 Solana 程序所需的全部工具。
- 使用官方安装命令安装 Solana CLI 工具集：
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
您可以将 stable 替换为与所需版本软件相匹配的 release tag（例如
v2.0.3），或者使用三个符号通道名称之一：stable、beta 或 edge。
- 添加 PATH 环境变量
首次安装 Solana CLI 时，可能会提示您添加 PATH
环境变量。为此，请关闭并重新打开终端，或在 shell 中运行以下命令：
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- 更新您的 PATH 环境变量
如果您使用的是 Linux 或 WSL，则必须将 Solana CLI 的二进制文件添加到 PATH 中，这样才能在终端中使用相关命令。请按照以下步骤操作：
a. 检查您正在使用的 shell 类型：
$echo $SHELL
- 如果输出包含
/bash，请使用.bashrc。 - 如果输出包含
/zsh，请使用.zshrc。
b. 根据你使用的 shell 运行相应的命令。
对于 Bash（bashrc）：
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
对于 Zsh（zshrc）：
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- 重新启动你的终端，或运行以下命令以刷新终端会话：
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- 通过检查 Solana CLI 版本，验证安装是否成功：
$solana --version
你将看到类似以下的输出：
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
你可以在 Agave Github 仓库 查看所有可用版本。Agave 是来自 Anza 的 validator 客户端，前身为 Solana Labs validator 客户端。
- 如有需要，更新 Solana CLI 到最新版本（可选）
$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，请按照以下步骤操作：
- 使用以下命令安装 AVM：
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- 确认 AVM 是否安装成功：
$avm --version
- 使用 AVM 安装 Anchor CLI：
要安装最新版本：
$avm install latest$avm use latest
要安装指定版本，请指定版本号：
$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)
如果你看到此错误信息，请按照以下步骤操作：
- 安装本页顶部 Linux 部分列出的依赖项。
- 重新尝试安装 Anchor CLI。
- 验证安装是否成功，检查 Anchor CLI 的版本：
$anchor --version
你将看到类似如下的输出：
anchor-cli 0.31.1
别忘了运行 avm use 命令，在你的系统上声明要运行的 Anchor CLI 版本。
- 如果你安装了
latest版本，请运行avm use latest。 - 如果你安装的是
0.30.1版本，请运行avm use 0.30.1。
安装 Surfpool CLI
Surfpool 是一个用于本地开发的工具，也是
solana-test-validator 的增强替代品。了解 Surfpool 的更多功能，请参阅
Surfpool 文档。
- 使用以下命令安装 Surfpool：
$curl -sL https://run.surfpool.run/ | bash
- 验证 Surfpool CLI 是否安装成功，检查其版本：
$surfpool --version
您将看到类似以下的输出：
surfpool 0.12.0
配置 Solana 开发的 AI 工具
本节介绍可选的 AI 工具配置，帮助您加速 Solana 开发。
| 工具 | 描述 | 链接 |
|---|---|---|
| MCP | 可通过 cursor 连接的 MCP 服务器，提升 Solana AI 辅助开发体验。 | https://mcp.solana.com/ |
| LLMs.txt | 针对 LLM 优化的文档，可用于训练 LLMs 学习 Solana 文档。 | https://solana.com/llms.txt |
Is this page helpful?