安装
本节介绍设置本地 Solana 开发环境的步骤。
快速安装
在 Mac 和 Linux 上，运行以下单行命令即可安装所有依赖项。
$curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash
Windows 用户：您必须先安装 WSL（请参阅安装依赖项）。然后在 Ubuntu（Linux）终端中运行上述命令。
安装完成后，您应该会看到如下输出：
Installed Versions:Rust: rustc 1.86.0 (05f9846f8 2025-03-31)Solana CLI: solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)Anchor CLI: anchor-cli 0.31.1Node.js: v23.11.0Yarn: 1.22.1
如果快速安装命令无法运行，请参阅下面的安装依赖项部分，了解如何单独安装每个依赖项的说明。
如果快速安装命令成功运行，请跳到下面的Solana CLI 基础和Anchor CLI 基础部分。
安装依赖项
以下说明将指导您逐一安装每个依赖项。
- Windows 用户必须先安装 WSL（Windows Subsystem for Linux），然后安装以下 Linux 部分中指定的依赖项。
- Linux 用户应首先安装以下 Linux 部分中指定的依赖项。
- Mac 用户应从下面的 Rust 安装说明开始。
安装 Rust
开发者使用 Rust 编程语言 构建 Solana 程序。
使用 rustup 安装 Rust。
运行以下命令安装 Rust：
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
安装完成后，您应该会看到以下消息：
运行以下命令重新加载您的 PATH 环境变量以包含 Cargo 的 bin 目录：
$. "$HOME/.cargo/env"
要验证安装是否成功，请检查 Rust 的版本：
$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。
首次安装 Solana CLI 时，您可能会看到以下消息，提示您添加一个 PATH 环境变量：
Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
如果您使用的是 Linux 或 WSL，需要将 Solana
CLI 二进制文件添加到您的 PATH 中，以便在终端中使用该命令。
首先，运行以下命令以检查您正在使用的 shell：
$echo $SHELL
- 如果输出包含
/bash，请使用.bashrc。 - 如果输出包含
/zsh，请使用.zshrc。
根据您的 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 repo 查看所有可用版本。
Agave 是 Anza 的验证器客户端，前身为 Solana Labs 验证器客户端。
要稍后将 Solana CLI 更新到最新版本，您可以使用以下命令：
$agave-install update
安装 Anchor CLI
Anchor 是一个用于开发 Solana 程序的框架。Anchor 框架利用 Rust 宏简化了编写 Solana 程序的过程。
您可以通过两种方式安装 Anchor CLI 和工具：
- Anchor 版本管理器 (AVM) - 推荐的安装方法
- 无 AVM - 直接从 GitHub 安装
Anchor 版本管理器 (AVM) 允许您在系统上安装和管理不同的 Anchor 版本，并在未来轻松更新 Anchor 版本。
使用以下命令安装 AVM：
$cargo install --git https://github.com/coral-xyz/anchor avm --force
确认 AVM 是否成功安装：
$avm --version
使用 AVM 安装最新版本的 Anchor CLI：
$avm install latest$avm use latest
您可以通过指定版本号来安装特定版本的 Anchor CLI：
$avm install 0.30.1$avm use 0.30.1
别忘了运行 avm use 命令来声明您系统上要运行的 Anchor CLI 版本。
- 如果您安装了
latest版本，请运行avm use latest。 - 如果您安装了
0.30.1版本，请运行avm use 0.30.1。
要验证安装是否成功，请检查 Anchor CLI 的版本：
$anchor --version
您应该会看到如下输出：
anchor-cli 0.31.1
在 Linux 或 WSL 上安装 Anchor CLI 时，您可能会遇到以下错误：
error: could not exec the linker cc = note: Permission denied (os error 13)
如果您看到此错误消息：
- 安装本页面顶部 Linux 部分中列出的依赖项。
- 重试安装 Anchor CLI。
Node.js 和 Yarn
使用 anchor init
命令创建的默认 Anchor 项目测试文件（TypeScript）需要 Node.js 和 Yarn。（可以使用
anchor init --test-template rust 获取 Rust 测试模板）
运行 anchor build 时，如果您遇到以下错误：
应用上述解决方案后，尝试再次运行 anchor build。
在 Linux 或 WSL 上创建新的 Anchor 项目后运行 anchor test
时，如果未安装 Node.js 或 Yarn，可能会遇到以下错误：
Permission denied (os error 13)
No such file or directory (os error 2)
Solana CLI 基础
本节将介绍一些常见的 Solana CLI 命令，帮助您入门。
Solana 配置
查看您当前的配置：
$solana config get
您应该会看到如下输出：
Config File: /Users/test/.config/solana/cli/config.ymlRPC URL: https://api.mainnet-beta.solana.comWebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)Keypair Path: /Users/test/.config/solana/id.jsonCommitment: confirmed
RPC URL 和 Websocket URL 指定了 Solana CLI 请求的 Solana 集群。
您可以使用以下命令更新 Solana CLI 集群：
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
您也可以使用以下简写选项：
$solana config set -um # For mainnet-beta$solana config set -ud # For devnet$solana config set -ul # For localhost$solana config set -ut # For testnet
Keypair Path 指向 Solana
CLI 用于支付交易费用和部署程序的默认 Solana 钱包（keypair）。默认情况下，此文件存储在
~/.config/solana/id.json。
创建钱包
要使用 Solana CLI 发送交易，您需要一个有 SOL 资金的 Solana 钱包。
要在默认 Keypair Path 生成一个 keypair，请运行以下命令：
$solana-keygen new
您应该会看到如下输出：
Generating a new keypairFor added security, enter a BIP39 passphraseNOTE! This passphrase improves security of the recovery seed phrase NOT thekeypair file itself, which is stored as insecure plain textBIP39 Passphrase (empty for none):Wrote new keypair to /Users/test/.config/solana/id.json===========================================================================pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT===========================================================================Save this seed phrase and your BIP39 passphrase to recover your new keypair:cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing===========================================================================
如果您已经在默认位置保存了一个文件系统钱包，此命令不会覆盖它，除非您明确使用
--force 标志强制覆盖。
要查看您钱包的地址（公钥），请运行：
$solana address
空投 SOL
请求向您的钱包空投 SOL，以支付交易和程序部署费用。
将您的集群设置为 devnet：
$solana config set -ud
然后请求一个 devnet SOL 的空投：
$solana airdrop 2
Devnet 空投每次请求限制为 5 SOL。如果您遇到速率限制或错误，请尝试使用 Web Faucet。
要检查您的钱包 SOL 余额，请运行以下命令：
$solana balance
Anchor CLI 基础
本节介绍了一些常见的 Anchor CLI 命令，帮助您入门。有关 Anchor CLI 的更多信息，请参阅 Anchor 文档。
初始化项目
要创建一个新的 Anchor 项目，请运行以下命令：
$anchor init <project-name>
例如，要创建一个名为 my-project 的项目，请运行：
$anchor init my-project
此命令会创建一个以项目名称命名的新目录，并初始化一个包含基础 Rust 程序和 TypeScript 测试模板的 Anchor 项目。
导航到项目目录：
$cd <project-name>
查看 Anchor 项目的 文件结构。
测试程序
要测试您的项目，请运行以下命令：
$anchor test
此命令会构建、部署并运行您的项目测试。
当使用 localnet 作为 cluster
时，Anchor 会自动启动一个本地 validator，部署您的程序，运行测试，然后停止 validator。
Is this page helpful?