安装依赖项
本指南将帮助您设置本地 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
替换为与您所需版本匹配的软件版本标签(例如 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 的验证器客户端,前身为 Solana Labs 验证器客户端。
- 根据需要将 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
。
为 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?