安装依赖项
本指南将帮助您设置本地 Solana 开发环境。了解如何在 Windows (WSL)、Linux 和 Mac 上安装 Rust、Solana CLI 和 Anchor Framework。如果您希望单独安装每个依赖项，或者快速安装因某些原因失败，请使用本指南。
前置条件
安装 Rust
开发者使用 Rust 编程语言构建 Solana 程序。
- 使用 rustup 安装 Rust，在终端中输入以下命令：
Terminal
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
安装成功后，您将看到以下消息：
- 重新加载您的 PATH 环境变量，以包含 Cargo 的 bin 目录：
Terminal
$. "$HOME/.cargo/env"
- 验证安装是否成功。
Terminal
$rustc --version
您将看到类似以下的输出：
rustc 1.86.0 (05f9846f8 2025-03-31)
安装 Solana CLI
Solana CLI 提供了构建和部署 Solana 程序所需的所有工具。
- 使用官方安装命令安装 Solana CLI 工具套件：
Terminal
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
您可以将 stable 替换为与您所需版本匹配的软件版本标签（例如 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 类型：
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
- 重启您的终端或运行以下命令以刷新终端会话：
Terminal
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- 通过检查 Solana CLI 版本来验证安装是否成功：
Terminal
$solana --version
您将看到如下输出：
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
您可以在 Agave Github 仓库 查看所有可用版本。Agave 是 Anza 的验证器客户端，前身为 Solana Labs 验证器客户端。
- 根据需要将 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，请按照以下步骤操作：
- 使用以下命令安装 AVM：
Terminal
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- 确认 AVM 是否成功安装：
Terminal
$avm --version
- 使用 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)
如果您看到此错误消息，请按照以下步骤操作：
- 安装本页面顶部 Linux 部分列出的依赖项。
- 重试安装 Anchor CLI。
- 验证安装是否成功，检查 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 开发。
| 工具 | 描述 | 链接 |
|---|---|---|
| MCP | MCP 服务器，您可以通过光标连接以改进 Solana 的 AI 辅助开发。 | https://mcp.solana.com/ |
| LLMs.txt | 优化的 LLM 文档，您可以使用它来训练 Solana 文档上的 LLM。 | https://solana.com/llms.txt |
Is this page helpful?