当你需要安装特定版本,或快速安装未能成功完成时, 请单独安装每个依赖项。 新环境请按顺序阅读各部分,或直接跳转到 你需要安装或排查问题的工具。
前置条件
安装 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
该命令会输出已安装的 Rust 版本,例如:
rustc x.y.z (...)
安装 Solana CLI
Solana CLI 提供了构建和部署 Solana 程序所需的全部工具。
- 使用官方安装命令安装 Solana CLI 工具集：
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
你可以将 stable 替换为特定的 Agave 发布标签,或替换为 beta
或 edge 发布渠道。
- 让 Solana CLI 在当前终端中可用。
安装程序会更新你的 shell 配置,并输出用于更新当前会话所需的命令。该命令通常为:
$export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
如果仍然无法使用 solana,请重启终端。若要确认安装程序更新了哪个 shell
配置文件,请检查当前使用的 shell:
$echo $SHELL
- 如果输出包含
/bash,请重启终端或运行source ~/.bashrc。 - 如果输出包含
/zsh,请重启终端或运行source ~/.zshrc。
- 验证安装是否成功:
$solana --version
该命令会输出已安装的 Solana CLI 版本,例如:
solana-cli x.y.z (..., client:Agave)
你可以在 Agave GitHub 仓库中查看所有可用版本。Agave 是 Anza 推出的 validator 客户端,前身为 Solana Labs validator 客户端。
- 如需日后更新 Solana CLI,请运行:
$agave-install update
安装 Anchor CLI
Anchor 是一个用于开发 Solana 程序的框架。Anchor 框架利用 Rust 宏，简化了编写 Solana 程序的流程。
前置条件
只有在选择 TypeScript 测试模板(如 Mocha 或 Jest)时,才需要 Node.js 和 JavaScript 包管理器。默认的 LiteSVM 测试 模板基于 Rust 运行,不需要 Node.js 工具链。
安装
您可以通过两种方式安装 Anchor CLI 和相关工具：
- Anchor Version Manager (AVM) — 推荐的安装方式
- 不使用 AVM — 直接从 GitHub 安装
Anchor 版本管理器（AVM）可以让你在系统上安装和管理不同的 Anchor 版本，并且未来可以轻松更新 Anchor 版本。要使用 AVM 安装 Anchor，请按照以下步骤操作：
- 使用以下命令安装 AVM：
$curl -sSfL https://raw.githubusercontent.com/otter-sec/anchor/master/avm/install | sh
- 确认 AVM 是否安装成功：
$avm --version
- 使用 AVM 安装 Anchor CLI：
要安装最新版本：
$avm install latest$avm use latest
要安装指定版本，请指定版本号：
$avm install 1.1.2$avm use 1.1.2
在 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 版本,例如:
anchor-cli 1.1.2
运行 avm use 为你的系统选择 Anchor CLI 版本。
- 如果你安装的是最新版本,请运行
avm use latest。 - 如果你安装的是
1.1.2版本,请运行avm use 1.1.2。
安装 Surfpool CLI
Surfpool 是一款本地开发工具,也是
solana-test-validator 的改进版替代方案。
- 使用以下命令安装 Surfpool:
$curl --proto '=https' --tlsv1.2 -sSfL https://run.surfpool.run/ | bash
- 通过检查 Surfpool CLI 版本来验证安装是否成功:
$surfpool --version
该命令会输出已安装的 Surfpool CLI 版本,例如:
surfpool x.y.z
Is this page helpful?