安装
学习如何在 Windows (WSL)、Linux 或 Mac 上安装 Rust、Solana CLI 和 Anchor 框架。
本节覆盖了设置您本地环境以进行 Solana 开发的步骤。
安装依赖包
- Windows 用户必须首先安装 WSL（Windows 子系统 Linux），然后安装以下 Linux 部分中指定的依赖包。
- Linux 用户应该首先安装以下 Linux 部分中指定的依赖包。
- Mac 用户应首先按照以下的 Rust 安装说明进行操作。
安装 Rust
Solana 程序是用 Rust programming language 编写的。
推荐的 Rust 安装方法是 rustup。
运行以下命令以安装 Rust：
安装完成后，您应看到以下消息：
运行以下命令以重新加载您的 PATH 环境变量以包含 Cargo 的 bin 目录：
要验证安装是否成功，请检查 Rust 版本：
您应看到类似于以下的输出：
安装 Solana CLI
Solana CLI 提供构建和部署 Solana 程序所需的所有工具。
使用官方安装命令安装 Solana CLI 工具套件：
您可以将 stable 替换为与您所需版本的软件发行版匹配的版本标签（例如 v2.0.3），或者使用以下三个符号通道名称中的一个：stable、beta 或 edge。
如果您第一次安装 Solana CLI，您可能会看到以下消息提示您添加 PATH 环境变量：
如果您使用的是 Linux 或 WSL 终端，您可以通过运行安装时记录的命令或重启终端将 PATH 环境变量添加到 shell 配置文件中。
要验证安装是否成功，请检查 Solana CLI 版本：
您应看到类似于以下的输出：
您可以在 Agave Github repo 查看所有可用版本。
Agave 是 Anza 的验证客户端，以前称为 Solana Labs 验证客户端。
要稍后将 Solana CLI 更新到最新版本，您可以使用以下命令：
安装 Anchor CLI
Anchor 是一个用于开发 Solana 程序的框架。Anchor 框架利用 Rust 宏简化了编写 Solana 程序的过程。
安装 Anchor CLI 和工具有两种方式：
- 使用 Anchor 版本管理器 (AVM) - 这是推荐的安装方法，因为它简化了将来 Anchor 版本的更新
- 无 AVM - 这需要更多的手动过程来稍后更新 Anchor 版本
Anchor 版本管理器 (AVM) 允许您在系统上安装和管理不同的 Anchor 版本，包括更轻松地在将来更新 Anchor 版本。
使用以下命令安装 AVM：
测试以确保 AVM 已成功安装并可访问：
使用 AVM 安装最新版本的 Anchor CLI：
或通过声明您想要安装的版本来安装特定版本的 Anchor CLI：
请不要忘记运行
avm use命令以声明系统上应该使用哪个 Anchor CLI 版本。
- 如果您安装了
latest版本，请运行avm use latest。- 如果您安装了
0.30.1版本，请运行avm use 0.30.1。
您可能在安装过程中看到以下警告。但是，这不会影响安装过程。
要验证安装是否成功，请检查 Anchor CLI 版本：
您应看到类似于以下的输出：
在 Linux 或 WSL 上安装 Anchor CLI 时，您可能会遇到此错误：
如果您看到此错误消息，请遵循以下步骤：
- 安装在此页面顶部列出的 Linux 部分中的依赖项。
- 重试安装 Anchor CLI。
Node.js 和 Yarn
Node.js 和 Yarn 是运行使用 anchor init 命令创建的默认 Anchor 项目测试文件（TypeScript）所必需的。（Rust 测试模板也可以使用 anchor init --test-template rust 可用）
当运行 anchor build 时，如果您遇到类似于以下 "error: not a directory" 的错误：
请尝试以下解决方案：
- 使用以下命令强制安装：
- 如果上面的办法无效，请清除 Solana 缓存：
应用其中任何解决方案后，请再次尝试运行 anchor build。
如果您在 Linux 或 WSL 上且创建新的 Anchor 项目后运行 anchor test 时遇到以下错误，可能是因缺失 Node.js 或 Yarn 所致：
Solana CLI 基础知识
本节将介绍一些常见的 Solana CLI 命令，以帮助您入门。
Solana 配置
要查看当前配置：
您应看到类似于以下的输出：
RPC URL 和 Websocket URL 指定了 CLI 将请求的 Solana 集群。默认情况下将使用 mainnet-beta。
您可以使用以下命令更新 Solana CLI 集群：
您也可以使用以下短选项：
Keypair 路径指定了 Solana CLI 用于支付交易费用和部署程序的默认钱包的位置。默认路径是
~/.config/solana/id.json。接下来的步骤将介绍如何在默认位置生成一个 keypair。
创建钱包
要使用 Solana CLI 与 Solana 网络进行交互，您需要一个资金充足的 Solana 钱包。
要在默认 Keypair 路径生成一个 keypair，请运行以下命令：
您应看到类似于以下的输出：
如果您已经在默认位置保存了文件系统钱包，则此
命令不会覆盖它，除非您明确强制覆盖使用
--force 标志。
生成 keypair 后，您可以使用以下命令获取 keypair 的地址（公钥）：
空投 SOL
一旦您设置好了本地钱包，请请求 SOL 的空投以资助您的钱包。您需要 SOL 来支付交易费用和部署程序。
将您的集群设置为 devnet：
然后请求 devnet SOL 的空投：
要检查钱包的 SOL 余额，请运行以下命令：
solana airdrop 命令目前在 devnet 上每次请求的限制为 5 SOL。错误通常是由于限速造成的。
替代方案，您可以通过 Solana Web Faucet 获取 devnet SOL。
运行本地验证器
Solana CLI 内置了 test validator。运行本地验证器将允许您在本地部署和测试程序。
在一个单独的终端中，运行以下命令以启动本地验证器：
请确保在运行命令之前将 Solana CLI 配置更新为 localhost。