设置本地开发环境并安装 Solana CLI

本快速入门指南将演示如何快速安装和设置本地开发环境，让你准备好开始开发和部署 Solana 程序到区块链。

你将学到什么 #

• 如何在本地安装 Solana CLI
• 如何设置本地主机 Solana 集群/验证器
• 如何创建用于开发的 Solana 钱包
• 如何为你的钱包空投 SOL 代币

本指南主要涵盖三种操作系统：Windows（使用 WSL）、Linux 和 MacOS。 在这些操作系统 之间，本地设置的主要步骤大致相同：

1. 安装依赖项
2. 安装 rust 和 cargo 工具链
3. 安装 Solana cli
4. 安装 Anchor
5. 设置本地区块链集群
6. 创建文件系统钱包
7. 向你的钱包空投 Solana 代币

1) 1) 安装依赖项 #

由于 Rust 将你的软件编译并构建为可以在我们指定的计算机架构上运行的二进制文件，我 们需要在机器上安装一些操作系统级别的依赖项。

Windows 的依赖项 #

你可以通过 WSL（Windows Subsystem for Linux）在 Windows 上开始使用 Solana。 WSL 允许你在 Windows 上轻松运行 Linux 软件，使用一个轻量级的虚拟机，当你需要时它会立 即启动。

为 Solana 开发设置 WSL #

首先从安装 WSL 开始。 在安装完成后务必重启计算机，然后继续本指南。

wsl --install

安装 WSL 并重启计算机后，使用 WSL 打开一个新的 Linux 终端会话：

wsl

在本指南的剩余部分以及你使用 WSL 进行 Solana 开发时，你将所有的命令、Solana 构建 和程序部署都在这个 Linux 终端中运行（除非本指南另有说明）。

如果你使用 VS Code 作为首选代码编辑器，我们建议 你按照本教程在 VS Code 网站上正确配置 VS Code 和 WSL。 这将为你提供最佳的开发者体验。

在你的 Linux/WSL 终端会话中，继续使用下面的“Linux”步骤设置你的本地 Solana 开发环 境。

由于文件系统写入速度的限制，WSL 有时可能会有点慢。 你也可以尝试双重启动你的计算 机，在同一台机器上本地安装一个 Linux 操作系统，或者使用基于完整网页浏览器的 Solana IDE，称为 Solana Playground。

Linux 的依赖项 #

在你的 Linux 系统上安装以下依赖项：

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

macOS 的依赖项 #

在 macOS 中，构建工具由 Xcode 命令行工具提供，你可以直接 从 Apple 下载。 你可能需要使用 Apple ID 登录才能下载。

你可以通过以下命令检查是否安装了 Xcode CLI：

xcode-select -p

如果没有返回路径，则需要安装 CLI 工具。

有三种方法可以安装 Xcode CLI 工具： #

1. 使用以下命令通过终端安装：

xcode-select --install

2. 下载安装程序并使用图形界面安装 Apple Developer Tools

   Xcode CLI from Apple

3. 通过 homebrew 安装：我们有以下指 南使用 Homebrew 安装 Xcode Command Line Tools

2. 安装 Rust #

Rust 编程语言是一种多范式、通用编程语言，强调性能、类型安全和并发性。

使用 rustup，官方的 Rust 版本安装程序和管理器，我们将一次 性安装rustc（Rust 编译器）和cargo（Rust 包管理器）。

为 macOS、Linux、WSL 或其他类 Unix 操作系统安装 Rust #

使用以下命令，我们可以在本地系统上安装和配置 Rust 工具链。 以下命令将自动下载适 用于你特定操作系统的正确二进制文件：

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

作为 Rust 安装程序的一部分，Rustup 还将配置你的终端的PATH以包含 Rust 工具链。

安装完成后，重启你的终端或运行以下命令手动刷新新的PATH设置，以使 Rust 工具 （如cargo）可用：

source ~/.bashrc

3. 安装 Solana CLI #

对于本地开发，包括编译你的 Solana 程序，你需 要安装 Solana CLI。 这个命令行工具套 件提供了执行常见任务所需的所有命令，例如：

• 创建和管理文件系统 Solana 钱包/密钥对
• 连接到 Solana 集群
• 构建 Solana 程序
• 将你的程序部署到区块链

对于 Linux、macOS、WSL 或其他类 Unix 系统： #

1. 使用官方安装命令安装 Solana CLI 工具套件：

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

2. 你可以将stable替换为与你所需版本的软件版本匹配的发布标签（例如v1.18.1）， 或使用三个符号通道名称之一：stable、beta或edge。

3. 根据你的具体操作系统，Solana CLI 安装程序可能会提示你更新PATH环境。

   Please update your PATH environment variable to include the Solana programs:
   

   如果你收到上述消息，只需复制并粘贴 Solana CLI 安装程序推荐的命令来更新你 的PATH环境变量。

   运行此命令后， 重启你的终端，以确保你的 Solana 二进制文件在你之后打开的所有终 端会话中都可访问。

4. 检查你的安装是否成功，检查 Solana CLI 版本：

   solana --version
   

你可以根据目标查看更多版本和发布 solana/releases

4. 为 Solana 安装 Anchor #

Anchor 是 Solana 运行时的框架，提供了几个方便的 开发工具来编写链上程序。 它通过使用 Rust 的宏抽象掉了许多安全 检查和常见样板代码，帮助你用更少的代码编写程序。

为了安装和管理 Anchor 版本，我们将使用avm，Anchor 版本管理器。 由于avm是通 过cargo（Rust 包管理器）安装的，安装步骤对于所有操作系统都是相同的。

然后我们可以使用avm安装所需版本的 Anchor 框架。

安装 avm #

cargo install --git https://github.com/coral-xyz/anchor avm --locked --force

使用 avm 安装 Anchor #

使用avm安装latest版本的 Anchor：

avm install latest
avm use latest

Anchor 安装完成后，你可以通过检查安装的版本来验证 Anchor 是否已安装：

anchor --version

如果你没有看到输出或收到错误，可能需要重启终端。

5. 设置本地主机区块链集群 #

Solana CLI 内置了 test validator。 这个 命令行工具将允许你在机器上运行一个完整的区块链集群：

solana-test-validator

配置你的 Solana CLI 以在所有未来的终端命令中使用你的本地主机验证器：

solana config set --url localhost

你可以随时查看当前的 Solana CLI 配置设置：

solana config get

6. 创建文件系统钱包 #

要使用 Solana CLI 部署程序，你需要一个带有 SOL 代币的 Solana 钱包，以支付区块链 上的交易和数据存储费用。

让我们创建一个简单的文件系统钱包，以便在本地开发期间使用：

solana-keygen new

默认情况下，solana-keygen命令将在~/.config/solana/id.json位置创建一个新的文 件系统钱包。 你可以使用--outfile /path选项手动指定输出文件位置。

将新钱包设置为默认钱包 #

创建新的文件系统钱包后，你必须告诉 Solana CLI 使用此钱包来部署和拥有你的链上程 序：

solana config set -k ~/.config/solana/id.json

7. 向你的钱包空投 SOL 代币 #

一旦你的新钱包设置为默认钱包，你可以请求免费空投 SOL 代币到它：

solana airdrop 2

你可以随时检查当前钱包的 SOL 余额：

solana balance

下一步 #

请参阅以下链接，了解更多关于编写基于 Rust 的 Solana 程序的信息：

• Create and deploy a Solana Rust program
• 编写 Solana 程序概述