开发环境搭建

工欲善其事，必先利其器。在开始编写第一行 Rust 代码之前，我们需要配置好开发环境。

Solana 的开发工具链比较复杂，包括 Rust 编译器、Solana CLI 工具套件以及 Node.js 环境。幸运的是，现在有了一键安装脚本。

一键安装 (推荐)

Solana 官方提供了一个便捷的安装脚本，可以一次性安装所有必要的开发工具。

在终端中运行以下命令：

bash
sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

或者使用社区维护的集成安装脚本（包含 Rust 和 Node）：

bash
curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

这个脚本会自动安装 Rust 工具链、Solana CLI、Anchor CLI（可选）、Node.js 和 Yarn。安装成功后，你会看到类似以下的输出：


Installed Versions:
Rust: rustc 1.91.1 (ed61e7d7e 2025-11-07)
Solana CLI: solana-cli 3.0.10 (src:96c3a851; feat:3604001754, client:Agave)
Anchor CLI: anchor-cli 0.32.1
Node.js: v24.10.0
Yarn: 1.22.1

运行以下命令验证安装是否成功：

bash
rustc --version && solana --version && node --version

Windows 用户须知 🪟

重要提示： 在 Windows 上开发 Solana 程序，必须使用 Windows Subsystem for Linux (WSL)。

这是因为 Solana 的 BPF (Berkeley Packet Filter) 编译工具链高度依赖 Linux 环境，直接在 Windows PowerShell 或 CMD 中运行会遇到各种兼容性问题。

安装 WSL 的步骤：

以管理员身份打开 PowerShell。
运行 wsl --install。
重启电脑。
按提示创建 Linux 用户账户和密码。
在开始菜单搜索「Ubuntu」打开 Linux 终端。

VS Code 技巧：安装 "WSL" 扩展插件。这样你可以在 Windows 上打开 VS Code，但它实际上是连接到内部的 Linux 环境进行编译和运行的，体验非常丝滑。

Linux 用户须知 🐧

使用 Debian/Ubuntu 系统的用户，需要先安装一些系统依赖，否则安装过程中编译可能会失败：

bash
sudo apt-get update
sudo apt-get install -y build-essential pkg-config libudev-dev llvm libclang-dev protobuf-compiler libssl-dev

使用 Fedora/RHEL 系统的用户，执行：

bash
sudo dnf upgrade --refresh
sudo dnf group install c-development development-tools
sudo dnf install pkg-config openssl-devel

手动安装（备选方案）

如果一键安装脚本因网络原因失败，你可以手动分步安装。

1. 安装 Rust 这是 Solana 程序的基础语言。

bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装完成后，运行 rustup --version 和 cargo --version 确认安装成功。

2. 安装 Solana CLI 然后参考 Solana 官方文档安装 CLI 工具套件。