Solana开发设置指南（第一部分：CLI）

solana_dev_tips
发布于 2025-04-07 13:33
阅读 16

本文是Solana CLI配置的详细教程，指导开发者快速上手Solana CLI工具，包括安装必要的依赖环境（NVM/FNM, Node.js, PNPM, Rust）、Solana CLI，配置Devnet环境，创建Devnet钱包并获取免费的Devnet SOL，以及Solana区块链浏览器Solscan的使用。

### 在 Solana 上构建快速、廉价和有趣的项目，设置 CLI 并获得免费的 Solana Devnet SOL。

本指南通过**实际步骤**，帮助开发者快速从零开始设置 Solana CLI。

**我们将开始一个新的教程系列**，其中 90% 是动手构建产品，10% 是回顾其工作原理的理论。

**重点是快速获得成果，并在做的过程中获得乐趣。** 但是，**我们确实需要先安装一些先决条件**，在本教程和接下来的教程中。

Solana Devnet 是一个免费、安全的沙箱，它镜像了 Solana 的主网（live），非常适合在 _不_ 花费真 SOL 的情况下进行实验。你将获得一些免费的 devnet SOL！

![](https://img.learnblockchain.cn/2025/04/24/1KWDzzaKRR19r3tQ-lAfQWg.jpeg)

**这是为想要发布 Solana 应用程序的人准备的 “设置系列” 序言的第一部分。** 在 Solana 上进行开发是跨学科的，涵盖了广泛的技术，从 CLI，到前端（如 Next.js），到链下的 Node.js 或其他后端脚本，当然还有 Rust/Anchor 中的链上后端程序。

你可以通过其他方式开始，但是 **Solana CLI 是一个很好的起点，因为我们可以安装许多以后需要的库，** 而且 **它不需要任何编码。** 如果你想要更多的理论和云开发者的概述，那么你可能想查看我的文章：[Solana for Cloud Developers](https://learnblockchain.cn/article/14586)…… 或者查看 [Solana Developer 文档](https://solana.com/docs)。

**🙋‍♂️ 为什么要关注我的设置文章？** 你也可以去 Solana 文档中查找设置信息，但是，我在此过程中添加了自己的技巧和窍门，并将其设计为适合我们以后会使用的有趣的应用程序和技术栈！

🚀 在本教程和接下来的 2 个教程中完成基本设置后，我们将进行 **有趣的应用程序**！你可以继续参考前 3 个教程（CLI、Javascript/Node.js/Next.js 和 Anchor/Rust）……

🔥 激动起来，**你正处于 Solana 生态系统中伟大事件的边缘！**

🥷🏻 我们前面有一个非常小的 **加粗**ninja**加粗** 战斗：**安装所有东西！** 在那之后，我们将熟悉 CLI，我们的命令行工具包，用于完成任务。

**🛠️ 安装应该相当快。** 然后我们将开始 Solana 构建 💯🚀

⚠️ **为什么要使用 Devnet 而不是仅本地的验证器？** 我们将在某个时候使用本地验证器，但是，首先我们要使用在线区块浏览器和其他涉及查看 Devnet 的任务。本地验证器对于开发中的快速迭代来说很好，所以我们以后可以使用它。

**⚠️ Windows 用户：** 我使用的是 MacOS 和 Linux，但是 Windows 用户可以/应该使用 Windows Subsystem Linux (WSL) 和 Solana CLI（Solana 开发者推荐）。Solana CLI 安装说明中有一个部分解释了 Windows 用户的更多详细信息。请看：“[Windows Subsystem Linux (WSL)](https://solana.com/docs/intro/installation#install-dependencies)”

01. **安装 NVM/FNM、Node.js、PNPM、Rust（必需）。**
02. **安装 Solana CLI。**
03. **为 Devnet 配置 CLI。**
04. **创建一个 Devnet 钱包。**
05. **通过空投获得免费的 Devnet SOL。**
06. **用于获取信息的基本 CLI 命令。**
07. **用于交易的 CLI。**
08. **在 Solana Explorer 上查看：Solscan.io (devnet)**
09. **Solana Toolkit / “Mucho”（新的 CLI 助手）**
10. **🥷🏻秘密 Solana CLI 命令（奖励）**
11. **其他 Solana 资源**

**📝 关于 Solana Devnet 的一些快速说明：**

- **免费使用。** Solana Devnet 不需要真正的 SOL，因此你可以安全地进行实验而无需花钱。
- **相同的运行时。** 它的行为几乎与 Solana Mainnet 完全相同，使其成为真实世界测试的理想选择。
- **公共水龙头。** 请求免费的测试 SOL 来资助你的 Devnet 钱包。
- **干净的重置。** 网络会定期重置，因此不要期望长期的数据持久性。
- **非常适合调试。** 交易日志和程序输出在 Devnet 上更容易跟踪和调试。
- **可在 Solana 浏览器中查看。** 你可以在 Solana 区块链浏览器中查看你的交易。**只要确保将其切换到 Devnet！**

缺点，请注意以下几个缺点：

- **空投速率受限制，有时会延迟。** 你无法立即从 devnet 获得 100 个 dev SOL。通常每小时（或更长时间）只有 1-2 个 SOL，因此你必须尝试少量 SOL。而且，如果你使用 VPN 代理或默认的 devnet url，则更容易受到速率限制。本文下面有一些关于如何处理此问题的建议。可以说，有时这可能有点痛苦。
- **在极少数情况下，Devnet 的性能可能会降低。** 它是用于开发者测试和实验的，这可能会导致一些问题，从而在一段时间内降低效率。

## 1\. 安装 nvm/fnm, Node.js (必需)

首先，我们需要在下面的这些步骤中安装 Solana CLI 的 Node.js 要求。nvm 和 fnm 是更改 Node.js 版本的方法。**在本教程系列开始之前，这是必需的。** 注意：**nvm** 是一种更流行的选择；**fnm** 是更新的，类似于 nvm，但在跨平台方面更广泛可用。

**⚠️ Windows：** 必须使用 Windows Subsystem Linux (WSL) 才能使用 Solana CLI。Solana CLI 安装说明中有一个部分。请看：“[Windows Subsystem Linux (WSL)](https://solana.com/docs/intro/installation#install-dependencies)”

![](https://img.learnblockchain.cn/2025/04/24/1itIX31CeMwnYQIF2uoyg0w.png)

我试图简化下面的说明，但如果你需要进一步的参考或遇到错误，请查看：**Solana 文档说明以获取更多信息：**[**https://solana.com/docs/intro/installation**](https://solana.com/docs/intro/installation)

### **1.1 — 验证是否已安装 Node.js (必需)**

**nvm 是 Node.js 版本管理器，** 允许你在 MacOS 上安装和切换多个 Node.js 版本。**FNM (Fast Node Manager)** 在 Windows 上执行此操作。

**Node.js 用于运行我们需要执行的各种命令、脚本和安装程序。 你使用 NVM 来安装 Node.js 版本。** 如果你没有安装它，我们将无法走得很远 — 所以请确认已安装。

检查你的命令行中是否安装了 Node：

**1\. 确认已安装 Node.js**

```
node -v

## 输出，如果成功，版本可能会有所不同

v22.14.0
```

**2\. 确认已安装 NVM 或 FNM**（此处的示例是 MacOS NVM，对于 Windows 请使用 `fnm — version`）

```
nvm -v

## 输出，如果成功，版本可能会有所不同

0.39.0
```

**3\. 确认已安装 pnpm** — 像 npm 但速度快得多

```
pnpm -v

## 输出，如果成功，版本可能会有所不同

8.15.7
```

**4\. 确认已安装 Rust。**

```
rustc --version

## 输出，如果成功，版本可能会有所不同

rustc 1.85.0 (4d91de4e4 2025-02-17)

```

_在上面的示例中，我在 MacOS 上安装了全部 4 个。_

## 查看安装

**如果任何一个未安装，** 你将收到错误或没有版本信息。

- **如果一切都适合你，** 请继续下面的 “2. 安装 Solana CLI” 步骤
- **如果某些或所有都** **没有** **工作，** 请转到下一步 1.2 安装它们。
- **如果你只需要** `pnpm` **，** 运行下面的安装，然后跳至 “2. 安装 Solana CLI” 步骤
- **如果你只需要 Rust，** 你可以转到步骤 1.3 中的相应部分。

```
## 下载并安装 pnpm：
corepack enable pnpm

## 验证 pnpm 版本：
pnpm -v
```

**🙋‍♂️ 我们需要 pnpm 吗？** 是的，它比 npm 快。 如果你熟悉 npm，请以完全相同的方式使用它，只需改用 `pnpm` 即可。 如果由于某种原因你绝对不能这样做，那么使用 npm 应该也可以，但是我的示例将尽可能坚持使用 pnpm，因此你必须翻译一下。

**🙋‍♂️ 我们需要 nvm OR fnm 吗？** 是的，你应该根据你的系统安装其中一个。 有时你可能需要切换 Node.js 版本才能进行我们的工作。

### **1.2 — 安装 nvm/fnm、Node.js、pnpm、Rust（如果需要）**

我们将安装 nvm 或 [fnm](https://github.com/Schniz/fnm)、Node.js 和 pnpm（三个安装）。

有几种安装方法。

我在下面列出了我推荐给 MacOS 和 Windows 的方法，但是你可以通过此处的链接更改一些设置：[可配置的安装说明](https://nodejs.org/en/download)，具体取决于你的操作系统（Windows、MacOS、Linux 等）等几个选项。

![](https://img.learnblockchain.cn/2025/04/24/19FHtI-Ey6c2ElrpJjxqhlQ.png)

[可配置的安装说明](https://nodejs.org/en/download)

- **安装 MacOS 版本、Node.js 22、nvm、pnpm：**

```
## 下载并安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

## 代替重启 shell
\. "$HOME/.nvm/nvm.sh"

## 下载并安装 Node.js：
nvm install 22

## 验证 Node.js 版本：
node -v # 应该打印 "v22.14.0"。
nvm current # 应该打印 "v22.14.0"。

## 下载并安装 pnpm：
corepack enable pnpm

## 验证 pnpm 版本：
pnpm -v
```

- **安装 Windows 版本、Node.js 22、**[**fnm**](https://github.com/Schniz/fnm) **、pnpm：**

```
## 下载并安装 fnm：
winget install Schniz.fnm

## 下载并安装 Node.js：
fnm install 22

## 验证 Node.js 版本：
node -v # 应该打印 "v22.14.0"。

## 下载并安装 pnpm：
corepack enable pnpm

## 验证 pnpm 版本：
pnpm -v
```

### **1.3 — Rust 安装**

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

更新你的路径，以便它在你的终端中连接：

```
. "$HOME/.cargo/env"
```

检查版本：

```
rustc --version
```

## 2\. 安装 Solana CLI

Solana CLI 由 Anza (anza.xyz) 维护，该公司从 Solana Labs 接管了维护工作。 我们下载最稳定的版本。

CLI 就像一把瑞士军刀，可以从你的本地计算机或服务器快速完成任务。 例如，如果你想检查一个帐户、进行快速手动交易或获取信息。

要安装 CLI，请打开一个终端并运行：

```
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
```

你可能会收到一些其他消息，如果是这样但不确定该怎么做，请查看更多详细信息：[https://solana.com/docs/intro/installation#install-the-solana-cli](https://solana.com/docs/intro/installation#install-the-solana-cli)

### **2.1 — 将 CLI 添加到我们的 PATH**（将其连接到你的终端）

你可能需要重新启动终端才能生效。

Linux 和 Windows WSL 用户：

```
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
```

仅限 MacOS：

```
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc

source ~/.zshrc
```

### **2.2 — 通过获取 Solana 版本来测试它。**

```
solana --version

## 输出，版本可能有所不同

solana-cli 2.1.16 (src:a5744e79; feat:3271415109, client:Agave)
```

🥷🏻 ✅ 我们完成了 CLI 安装。

**如果你需要帮助进行故障排除，** 请首先查看 Solana CLI 安装文档，并且你也可以在 Solana Stack Exchange 上提问。

你也可以在评论中提问。 我会尽力提供帮助，或者其他人可能会知道！

## 3\. 为 Devnet 配置 CLI

Devnet 是我们将要玩耍的地方 — 让我们将 CLI 指向那里。

这将配置 Solana CLI，以便 Solana CLI 知道我们在发送交易或检查帐户时专门使用 Devnet。 否则，我们必须在说明中说明。

配置完成后，你无需在每个命令中指定网络。

**设置网络：**

`solana config set --url https://api.devnet.solana.com`

```
solana config set --url https://api.devnet.solana.com

## 输出，注意：这可能略有不同，
## 此示例的关键部分是 RPC URL：https://api.devnet.solana.com

Config File: /path/.config/solana/cli/config.yml
RPC URL: https://api.devnet.solana.com
WebSocket URL: wss://api.devnet.solana.com/ (computed)
Keypair Path: /Users/[你的用户名]/.config/solana/wallet.json
Commitment: confirmed
```

此命令的其他 CLI 選項：

solana config set — config <FILEPATH> ←url <URL\_OR\_MONIKER>\| — ws <URL>\| — keypair <KEYPAIR>\| — commitment <COMMITMENT\_LEVEL>>

- `Config File: /Users/[你的用户名]/.config/solana/cli/config.yml `

保存这些设置的配置文件在你计算机上的路径。 此 YAML 文件存储你的 CLI 首选项（如 URL 和钱包）。 它隐藏在你主目录下的 .config/solana/cli/
- `RPC URL: https://api.devnet.solana.com
` 远程过程调用 URL，你的 CLI 用于与 Solana 区块链通信的地址。 这证实了你的所有操作（如空投）都发生在 Devnet 上，而不是 mainnet 或 testnet 上。
- `WebSocket URL: wss://api.devnet.solana.com/ (computed)
` CLI 从 RPC URL 自动生成此 URL（将 https 替换为 wss）。 WebSockets 允许你侦听事件。 现在无需担心。
- `Keypair Path: /Users/[你的用户名]/.config/solana/wallet.json
` 你的钱包密钥对文件的位置，该文件保存你的公钥和私钥。 请保密。 **如果泄露，这是一个安全风险。** 不要将此未加密地保存在你的本地 PC 上以用于真正的生产 mainnet。 但是，对于开发，我们将这样做，因为我们使用的是假的 dev SOL。
- `Commitment: confirmed
`“Confirmed” 表示一旦大多数节点同意交易有效（在 Devnet 上大约 1-2 秒，速度很快），CLI 就会认为交易已完成。 存在其他选项，例如 “finalized”（速度较慢，但更确定），但这是默认设置。 这可能会影响你的游戏或操作感觉响应的速度 — 目前速度越快越好。

**验证配置：**

`solana config get`（应显示 Devnet URL）。

这只是获取上面配置中输入的相同信息。 也许你忘记了你的设置是什么。

**检查集群状态：**

`solana cluster-version`（确认连接）。

这只是确认我们已连接。

如果存在连接问题，它将返回错误。

## 4\. 创建一个 Devnet 钱包

我们正在创建一个 **Solana CLI 文本钱包，** 如果你以前没有这样做过，那么这可能与你期望的不同。

- **CLI 钱包** 意味着钱包保存在你的本地文件系统中，而不是像你可能习惯的那样在浏览器中。 我有目的地这样做是为了你的学习，因为这是理解某些内容所必需的。
- 大多数人熟悉像 **Phantom** 或 **Backpack** 钱包这样的 Chrome 钱包。 **这执行相同类型的任务，但它只在 CLI 上，而不是在你的 Chrome 浏览器中，没有颜色和 UI。**
- **在下一个教程中，我们将使用 Chrome 钱包** 并且会更多地讨论它。 但在这种情况下，它只是你本地文件系统上的一个特殊文本文件。
- **⚠️ 重要提示：此类型的钱包文件未加密。 因此，如果有人窃取了此文件，他们将拥有你所有的 SOL、代币、钱。** 仅将其与 **devnet** SOL（假的）一起使用，不要在此处放入真正的 SOL。 即使是一些顶级的 Solana 开发者也曾有 CLI 钱包被盗的情况。 此文件存在安全风险，因此 **不** 建议使用，**除非** 用于我们使用假的 devnet SOL 进行学习/演示目的。

### 4.1 — 生成钱包密钥对

当你创建钱包时，它会有一个公钥和一个私钥（密钥），因此，它被称为 “密钥**对**”。 此文件应保密，切勿泄露。

在下面创建它的命令中，你可以更改名称 `dev-wallet.json` 和绝对文件路径为你想要的任何内容。 我将为示例使用 wallet-dev.json，并且路径取决于你的系统，因此请将你的路径替换为 `/path/to/file`

```
solana-keygen new --outfile /path/to/file/wallet-dev.json
```

🥷🏻 输出（示例）：

```
生成一个新的密钥对

为了增加安全性，请输入一个 BIP39 密码

注意！ 此密码提高了恢复**加粗**种子短语**加粗**的安全性，**加粗**而不是密钥对文件本身的安全性，该文件存储为不安全的纯文本

BIP39 密码（如果不需要密码则留空）：

已将新的密钥对写入 /path/to/file/wallet-dev.json
================================================================================
公钥：GtYM8YsjXCy2t9WqAgUbuWUpQYAxBLrT2r4u7G1F2S3p
================================================================================
保存此种子短语和你的 BIP39 密码以恢复你的新密钥对：
[这里将出现随机词，总共十二个，请保密]
```

- 对于开发/学习，请将密码留空。 通常在开发中不使用密码。
- **公钥：** 列出的是公钥。 **它不是秘密。** 你可以将其提供给其他人进行付款或向你转账代币，并且可以键入以获取公共帐户信息。 此处列出的公钥格式如下：

`GtYM8YsjXCy2t9WqAgUbuWUpQYAxBLrT2r4u7G1F2S3p`

- **密钥对文件**：以二进制格式包括 **私钥和公钥**。

**这是一个未加密的密钥文件，我们仅用于开发学习。 请勿泄露它，因为它包含你的私钥。** 这也是在你的笔记本电脑上（未加密）拥有该文件存在安全风险的原因，恶意软件可能会窃取该文件。 但是，我们仅将此钱包用于开发（开发代币）。 请勿在 Solana mainnet 上或在生产中使用它来存放真钱或真代币。

- **私钥：是一个秘密。** 请勿泄露。 可以从密钥对文件中提取此密钥。 如果有人获得此密钥，他们将完全访问你的钱包，并且可以 “耗尽”（从钱包中移除所有代币）。
- **“保存此种子短语”：这是一个用于恢复的助记词。 请勿泄露。** 给出的短语将是 12 个单词（**“** BIP39 短语”，是短语标准 **），可以用于恢复钱包。 如果其他人获得此短语，他们将完全访问你的钱包。**

请记住：你可以选择路径 / 目录，并将钱包文件命名为你想要的任何名称和 .json， 我只是在此使用 “wallet-dev”。

### 4.2 — 确认钱包设置和激活

验证你的密钥

```
solana-keygen verify <PUBKEY> /path/to/file/wallet-dev.json
```

输出：

```
验证公钥 GtYM8YsjXCy2t9WqAgUbuWUpQYAx....：成功
```

查看你当前的钱包，默认钱包：

```
solana address
```

对于我来说，我使用了其他钱包，因此即使我创建了上面的钱包，第一次 `solana address` 也给了我一个不同的公共地址。

原因是，我必须设置新钱包，我的旧钱包仍然设置为活动钱包。

### 4.3 — 设置活动钱包

如果你需要更改哪个钱包对你处于活动状态。

```
solana config set --keypair </path/to/file>/wallet-dev.json

## 输出：

Config File: /path/.config/solana/cli/config.yml
RPC URL: https://api.devnet.solana.com
WebSocket URL: wss://api.devnet.solana.com/ (computed)
Keypair Path: /path/to/file/wallet-dev.json
Commitment: confirmed
```

- 我们之前设置了 devnet
- 我们看到 Keypair Path 现在是正确的，它指向我们的新钱包。

再次确认地址

```
solana address

## 输出
GtYM8YsjXCy2t9WqAgUbuWUpQYAx....
```

🥷🏻 ✅ 是的，现在该地址是我们新创建的钱包的公钥。

## 5\. 通过空投获得免费的 Devnet SOL

我们需要免费的 devnet SOL。 在这一点上，除了检查信息之外，我们无法使用 CLI 做很多事情，因为钱包没有 SOL。

但是，我们可以获得 dev SOL 的 “空投”，然后开始进行一些交易。

devnet 上的 SOL 不是真正的 SOL，因此无法在实时主网上出售。

⚠️ 在执行空投之前，请注意：

- **如果你在使用 VPN 或共享 IP，它可能无法正常工作，** 因为如果许多人从同一 IP 发出请求，它将限制速率并阻止。 因此，如果它给你一个错误，这是首先要考虑的事情。
- **此外，它受到速率限制，** 你不能只是不断地请求无限量。 **通常，你可以每隔几分钟或一个小时执行 2 SOL**，但是 **如果网络繁忙，有时数量会更少**。
- **如果你因超时或速率限制而收到错误。** 请稍等片刻，然后重试。 或者尝试下面讨论的其他方法。
- ⚠️ **且不要浪费 dev SOL。** 它是免费的，但是有时可能存在速率限制或其他问题，导致你无法获得更多 SOL。 尝试积累一些 SOL，这样如果发生延迟，你就不会耗尽。

**空投：**

```
solana airdrop 1

## 错误输出 - 如果你收到速率限制错误
Error: airdrop request failed. This can happen when the rate limit is reached.
```

**我遇到了错误。 有时会发生这种情况。**

**通常，如果你使用第三方 RPC url/api 密钥，你会做得更好**（我们使用的是默认的 devnet RPC，它受到了很多开发者的slam）。 如果你想从 Helius 获得一个 RPC 密钥，请参阅我的文章：[**Building on Solana: Helius RPCs + Tutorial**](https://learnblockchain.cn/article/14584) **。** 或者，请按照以下说明获取 Web 开发代币水龙头。

如果你使用 Helius，这非常容易，你只需将我们之前为网络所做的配置更改为你获得的 Helius url 即可。

如果这不起作用，**你可以使用官方 Solana.com “水龙头”：**

- **每 8 小时最多两个请求**
- **我连接了我的 Github（仅用于电子邮件/个人资料），** 并且我在 dev 中获得了 5 SOL，这是一个不错的数量。

[https://faucet.solana.com/](https://faucet.solana.com/)

![](https://img.learnblockchain.cn/2025/04/24/1m8kd52I3Iwfwy0CbNJoFVQ.png)

✅ **“空投成功”**

使用以下命令检查你的余额：

```
## 空投之前

$ solana balance
0 SOL

## 空投之后

$ solana balance
5 SOL
```

## 6\. 用于获取信息的基本 CLI 命令（信息，时间）

我们可以执行许多其他基本命令来获取信息，这些信息可能因各种原因而有用。

让我们快速执行几个信息类 CLI 命令，以确保一切正常。 这是一个快速的胜利！

**获取 Solana 区块时间**，它显示了 Devnet 上最新区块的时间戳。

```
solana block-time

## 输出

Block: 368007187
Date: 2025-03-17T18:50:11Z
```

🥷🏻 `block-time` 的可能用例：

- 实时游戏触发器。
- 游戏的随机数种子。
- 交易基准计时。
- 与时间同步的实时事件。

你也可以获取 **Solana epoch**：

```
solana epoch-info

## 输出
```区块高度: 355993994
槽位: 368014511
纪元: 851
交易计数: 15336116514
纪元槽位范围: [367632000..368064000)
纪元完成百分比: 88.544%
纪元已完成槽位: 382511/432000 (剩余 49489)
纪元已完成时间: 1天 16小时 57分 45秒/1天 22小时 15分 18秒 (剩余 5小时 17分 33秒)
```

🥷🏻你可以通过编程方式获取这些信息，例如：

- 如果你想让一个特殊事件（比如奖品掉落）每个纪元发生一次，可以在游戏中使用。
- 跟踪 **staking** 奖励何时可能归属。
- 网络健康检查。
- 跟踪其他基于时间的竞赛或事件。

跟踪 SOL 的供应量（记住：如果你配置了，这是用于 **devnet** 的）
```
solana supply

## output

Total: 1280289349.0014498 SOL
Circulating: 964424387.3256116 SOL
Non-Circulating: 315864961.67583805 SOL
```

🥷🏻 你只需输入 `solana` 并回车，就可以获得完整列表

```
solana

## output

account                              显示账户内容
 address                              获取你的公钥
 address-lookup-table                 地址查找表管理
 airdrop                              从水龙头请求 SOL
 authorize-nonce-account              将账户权限分配给新的实体
 balance                              获取你的余额
 block                                获取已确认的区块

... etc
```

## 7. 交易的 CLI，在 Solscan.io 中查看

我们可以进行 **token** 的转移，通过发送到另一个公有地址来轻松验证 **wallet** 是否正常工作。**你甚至可以从你的 wallet 发送到你自己的 wallet —— 它仍然会被注册为一次转移！**

此外，我们预计余额会略有减少，因为所有交易都有网络费用。

首先，获取一个可以检查的公有地址。你甚至可以使用你自己的地址，然后像这样再次获取：

```
solana address

## output, 示例我的地址
GtYM8YsjXCy2t9...
```

现在让我们进行一次转移到你想检查的公有地址，甚至是我们自己（我试过了，它有效！）：

```
## transfer
solana transfer <PUBLIC_ADDRESS> 0.01 --no-wait

## output, 你的交易会不同
Signature: 2DJe8mZg7Pwbxx4RzN3oE3TJiGMr1nCo87zgvY1M67eZ2...

## check balance
solana balance
4.999995 SOL
```

✅ 我们将 .01 SOL 发送到了公有地址。如果你使用了你自己的地址，你也可以这样做！它不再是 `5` 了，因为有一个小的网络交易费用，所以它是 `4.999995 SOL`。

我们稍后会使用 `Signature`，所以请保留它。

## 8. 在 Solscan.io 区块浏览器中查看

**Solscan.io 是 Solana 区块浏览器的其中之一。** 我们将在某个时候深入研究区块浏览器，它们非常吸引人，但这将在以后的教程中进行！我们只是想检查我们的交易是否在那里。

**现在就去那里：** [**https://solscan.io/**](https://solscan.io/)

**Solana 区块浏览器，** 为你提供关于区块链上的交易、**token**、NFT 或账户的所有详细信息，以及额外的 **info**，例如账户的交易历史等等。

如果你从未用过或者更改过它，它默认使用 `mainnet` (live Solana) 进行所有查找。

由于我们使用的是 `Devnet` 而不是 **mainnet**，我们需要切换它以使用 **Devnet** 进行搜索。

**点击 Solana 徽标，点击它以打开下拉菜单** 并切换到 `Devnet`。

例如，见红色框：[https://solscan.io/](https://solscan.io/)

![](https://img.learnblockchain.cn/2025/04/24/1M7RFWm5yttqYDOrFYLAFlg.png)

我从之前复制了交易签名并将其粘贴到搜索栏中。

注意，它说 Transaction (1)，找到了。

立即在下拉菜单中找到。

![](https://img.learnblockchain.cn/2025/04/24/1O6_sFxOnQdLJLLPogR-3VA.png)

我点击了那个搜索结果。

🥷🏻 ✅ 现在，我确认下面这些

- 我在 Devnet 上，
- 对于我输入的签名 2DJe8m…
- 我的交易在 16 分钟前处理了，
- 我的 wallet GtYM8Y… 签署了交易
- 交易是在我自己的 wallet GtYM8Y… 和我的 wallet GtYM8Y 之间进行的。
- 这是一笔 0.01 SOL 的转移。

![](https://img.learnblockchain.cn/2025/04/24/16m4vSqRnwcA5Z4Duwc-2SQ.png)

### 其他 Solana 区块浏览器

我不想给你留下 Solscan 是唯一区块浏览器的印象，还有很多其他的，有些人更喜欢其他的，因为它们可能提供额外的功能。

其他流行的：

**Solana Explorer**

[https://explorer.solana.com/](https://explorer.solana.com/)

![](https://img.learnblockchain.cn/2025/04/24/1372xcCOZG4muCGWB_KcwQg.png)

**Solana.FM**

[https://solana.fm/](https://solana.fm/)

![](https://img.learnblockchain.cn/2025/04/24/15v6N5ARDdlO16_FdKovBvA.png)

**Helius Orb (formerly Xray, in Beta)**

[https://orb.helius.dev/?cluster=mainnet-beta](https://orb.helius.dev/?cluster=mainnet-beta)

![](https://img.learnblockchain.cn/2025/04/24/1wY2xZ34PGkPF-KhgqPloCQ.png)

这些只是一些。

## 9. Solana Toolkit / “Mucho” (新的 CLI 助手)

有一个全新的库叫做 [Solana Toolkit (aka “Mucho” library)](https://www.npmjs.com/package/mucho)，它是 CLI 的一个包装器。它应该使 CLI 的一些事情更容易，并且是为开发者构建的。它最近才发布。

**由于它很新，我没有广泛使用过。** 事实上，直到我写到这篇文章的这一点，我甚至不知道它的存在 🤣。

它看起来很有用，但这只是一个介绍，让你知道它的存在。它处于 **Beta** 阶段。此外，它还试图安装一些其他的依赖项。有些我有，有些我没有。所以它可能需要几分钟才能安装。

[**GitHub - solana-foundation/mucho: Command-line tool that simplifies the development and testing of…**
\\
\\
**Command-line tool that simplifies the development and testing of Solana blockchain programs. - solana-foundation/mucho**
\\
github.com](https://github.com/solana-foundation/mucho?source=post_page-----774b22aa72bd---------------------------------------)

这是一个必需的工具吗？不，它是一个**可选的，但有用的**工具包，它可能会帮助你，但如果你无法安装它，你可以在 **repo** 上询问你需要帮助的任何事项。我有一个小故障（一个警告错误），然而，在那之后它确实工作了，而我没有做任何调试（就我目前所知）

> “This is a beta version of the [Solana Toolkit](https://solana.com/docs/toolkit), and is still a WIP. Please post all feedback as a GitHub issue [here](https://github.com/solana-foundation/mucho/issues/new?title=%5Btoolkit%5D+).”

你可以像这样安装它: `npx -y mucho@latest install`

```
npx -y mucho@latest install

## output

mucho update available - v0.9.0
   To install the latest version, run the following command:
   npx mucho@latest self-update

Install Solana development tools
✔ mucho 0.9.0 installed
ℹ rust 1.85.0 is already installed
```

来自文档：

- `install` - 在你的系统上安装和管理 Solana Toolkit 的本地开发工具。
- `clone` - 从任何想要的 Solana 集群克隆账户和程序（又名 **fixtures**），并在 `Solana.toml` 中声明。
- `validator` - 在你的本地机器上运行 `solana-test-validator`，包括为你 **repo** 加载所有克隆的 fixture。
- `build` - 构建你的工作区中的所有或单个 Solana 程序。
- `deploy` - 部署你的工作区中的 Solana 程序。
- `coverage` - 在 Solana 程序上运行代码覆盖率测试。
- `info` - 收集关于你的设置的有用的故障排除信息。
- `docs` - 显示 Solana 开发工具的文档。
- `balance` - 获取所有集群的账户余额。
- `inspect` - 在 CLI 中检查交易、账户和区块（像区块浏览器）

**获取版本：**

```
mucho --version

## output

mucho 0.9.0
rustc 1.85.0 (4d91de4e4 2025-02-17)
node v22.14.0
solana-cli 2.1.16 (src:a5744e79; feat:3271415109, client:Agave)
solana platform tools:
  build-sbf: 2.1.1
  platform-tools: 1.43
```

你可以像这样获取关于你的系统的信息：

```
npx mucho info

## output

--- start mucho info ---
System Info:
[你的系统信息]
------------------------
Installed tooling:
  rustup: 1.28.1
  rust: 1.85.0
  solana: 2.1.1
  avm: 0.30.0
  anchor: 0.30.1
  node: 22.14.0
  yarn: 1.22.2
  trident: false
  zest: false
  cargo-update: 16.2.0
  verify: false
------------------------
Platform tools:
  build-sbf: ---
  platform-tools: ---
------------------------
Solana CLI info:
  Config File: [路径]/.config/solana/cli/config.yml
  RPC URL: https://api.devnet.solana.com
  WebSocket URL: wss://api.devnet.solana.com/ (computed)
  Keypair Path: [路径]/wallets/wallet-dev.json

Commitment: confirmed
Does CLI config.yml exist: true
Address: G....
Balances for address:
  devnet: 4.9995 SOL
  mainnet: 0 SOL
  testnet: 0 SOL
  localnet: false
Is test-validator running? false
Localnet url: http://127.0.0.1:8899
---- end mucho info ----
```

我有点想现在就开始介绍 **token** 的创建，但我们稍后再说！

我自己已经用 CLI 做了好几次了，但也许下次我们会使用 `mucho`

## 10. 🥷🏻秘密 Solana CLI 命令 (奖励)

在我写这篇文章的时候，另一个与 SOLANA CLI 相关的网站出来了。

这是……这好像是 3 天内的第二次了 😁

这不是必须知道的，事实上，这些中的许多我并不知道，而且我已经在这个生态系统中几年了。

**我不会在这里做一个完整的评论，** 但你可能想看看这个，以成为一个大师。

可能很有趣。

![](https://img.learnblockchain.cn/2025/04/24/10eN9GcFsc3sh9PbC-f7Dbg.png)

这里有一个命令列表，你可以获得关于每个命令的更多信息，例如这里：

![](https://img.learnblockchain.cn/2025/04/24/1R9V--evMXoowxhLLU8SxjA.png)

回顾一下，我们有了一个良好的开端。

**✅ 我们的目标是安装许多必需的 Solana 库。** 它们将在以后的任务中派上用场。

**✅ 我们了解了 Solana CLI。** 你可以做更多的事情，但这让你开始了，我们完成了一些有用的任务。

✅ **我们尝试了一些新的工具，比如 Mucho**，它们可能在以后派上用场。

接下来，我们将研究使用 **Javascript, Typescript** 和 **Node.js** 制作一些基本的实用脚本，以及使用 **Next.js** 框架进行 **wallet** 集成。如果你在这篇文章发布之前就到了这里，我将在接下来的 2-3 天或更短的时间内添加它！

**在那之后，我们将冒险进入 Solana Anchor 和 Rust**，在本系列设置文章的第三部分中。

🚀 **然后，我们将准备好开始做有趣的 Solana 应用程序了！** 你可以参考前 3 个教程（CLI、Javascript/Node.js/Next.js 和 Anchor/Rust），随着你继续……

🔥 **兴奋起来，你正处于成为 Solana 生态系统一部分的伟大事情的风口浪尖！**

## 其他 Solana 资源：

我可能会更新这些以适应变化/新的资源。

[**Solana Docs**](https://solana.com/docs) **:** 学习和使用 Solana 区块链的官方文档，包括设置指南、API 和协议详细信息。

[**Solana Faucet**](https://faucet.solana.com/) **:** 一个 **web** 工具，它给你免费的 Devnet SOL 来测试 Solana 应用程序，而无需花费真正的 **token**。

[**Solana Cookbook**](https://solana.com/developers/cookbook) **:** 一个开发者友好的指南，包含实用的、以代码为中心的秘诀，用于在 Solana 上构建应用程序和智能合约。

[**Solana Stack Overflow**](https://solana.stackexchange.com/) **:** 一个社区问答网站，开发者可以在这里提出和回答与 Solana 开发相关的技术问题。

[**Solana Developers GitHub**](https://github.com/solana-developers/) **:** Solana 核心和社区开发者协作、共享工具和维护开源 Solana 项目的 GitHub 组织。

[**Awesome Solana**](https://github.com/csjcode/awesome-solana) **:** 我的原创 **repo**。 巨大，有几年了，有一些断开的链接，我将尽快更新。 如果最近没有更新，请再次检查。

🥰 感谢阅读！… 🔥 请鼓掌并分享这篇文章，谢谢！🚀

**促销：我的云电子书商店**——非常棒的云架构师和工程师书籍，价值很高，“云指标”（800 多页）和“云审计”（800 多页）等等——[https://store.systemsarchitect.io](https://store.systemsarchitect.io/)

**35%** **折扣** **折扣码：35BLOG2025** 在结账时

[![](https://img.learnblockchain.cn/2025/04/24/0rXS-0q_rOLZY8pMY.jpeg)](https://store.systemsarchitect.io/) [https://store.systemsarchitect.io](https://store.systemsarchitect.io/)

## 关于我

我是一名云架构师、高级开发人员和技术负责人，我喜欢用创新的解决方案解决高价值的挑战。

我总是乐于讨论项目。 如果你在一个项目上需要帮助，有一个机会，或者只是想聊聊一个云问题，你可以在 csjcode at gmail 联系我。

[**Get an email whenever Chris St. John publishes.**
\\
\\
**Get an email whenever Chris St. John publishes. By signing up, you will create a Medium account if you don’t already…**
\\
medium.com](https://medium.com/@csjcode/subscribe?source=post_page-----774b22aa72bd---------------------------------------)

**我在 Medium 上的最新文章：** [https://medium.com/@csjcode](https://medium.com/@csjcode)

**Cloud Cost Saving:** [https://medium.com/cloud-cost-savings](https://medium.com/cloud-cost-savings)

**Cloud Architect Review:** [https://medium.com/cloud-architect-review](https://medium.com/cloud-architect-review)

**AI Dev Tips:** [https://medium.com/ai-dev-tips](https://medium.com/ai-dev-tips)

**API Dev Tips:** [https://medium.com/api-dev-tips](https://medium.com/api-dev-tips)

**Solana Dev Tips:** [https://medium.com/solana-dev-tips](https://medium.com/solana-dev-tips)

**我在软件开发领域工作了 20 多年**，既有 **企业** 环境，如 NIKE 和最初的 MP3.com，也有 **初创公司**，如 FreshPatents、SystemsArchitect.io、API.cc 和 Instantiate.io。

我的经验范围从 **云电子商务、API 设计/实现、** **serverless**、**AI 集成** 用于开发、内容管理、**前端 UI/UX 架构** 和登录/身份验证。 我进行技术讲座、教程，并分享用于构建软件的文档。 还持有过 AWS 解决方案架构师认证。

**35%** **折扣** **折扣码：35BLOG2025** 在结账时

>- 原文链接： [medium.com/solana-dev-ti...](https://medium.com/solana-dev-tips/solana-dev-setup-guide-part-1-cli-774b22aa72bd)
>- 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～

在 Solana 上构建快速、廉价和有趣的项目，设置 CLI 并获得免费的 Solana Devnet SOL。

本指南通过实际步骤，帮助开发者快速从零开始设置 Solana CLI。

我们将开始一个新的教程系列，其中 90% 是动手构建产品，10% 是回顾其工作原理的理论。

重点是快速获得成果，并在做的过程中获得乐趣。 但是，我们确实需要先安装一些先决条件，在本教程和接下来的教程中。

Solana Devnet 是一个免费、安全的沙箱，它镜像了 Solana 的主网（live），非常适合在不花费真 SOL 的情况下进行实验。你将获得一些免费的 devnet SOL！

这是为想要发布 Solana 应用程序的人准备的 “设置系列” 序言的第一部分。 在 Solana 上进行开发是跨学科的，涵盖了广泛的技术，从 CLI，到前端（如 Next.js），到链下的 Node.js 或其他后端脚本，当然还有 Rust/Anchor 中的链上后端程序。

你可以通过其他方式开始，但是 Solana CLI 是一个很好的起点，因为我们可以安装许多以后需要的库， 而且 它不需要任何编码。 如果你想要更多的理论和云开发者的概述，那么你可能想查看我的文章：Solana for Cloud Developers…… 或者查看 Solana Developer 文档。

🙋‍♂️ 为什么要关注我的设置文章？ 你也可以去 Solana 文档中查找设置信息，但是，我在此过程中添加了自己的技巧和窍门，并将其设计为适合我们以后会使用的有趣的应用程序和技术栈！

🚀 在本教程和接下来的 2 个教程中完成基本设置后，我们将进行 有趣的应用程序！你可以继续参考前 3 个教程（CLI、Javascript/Node.js/Next.js 和 Anchor/Rust）……

🔥 激动起来，你正处于 Solana 生态系统中伟大事件的边缘！

🥷🏻 我们前面有一个非常小的加粗ninja加粗战斗：安装所有东西！ 在那之后，我们将熟悉 CLI，我们的命令行工具包，用于完成任务。

🛠️ 安装应该相当快。 然后我们将开始 Solana 构建 💯🚀

⚠️ 为什么要使用 Devnet 而不是仅本地的验证器？ 我们将在某个时候使用本地验证器，但是，首先我们要使用在线区块浏览器和其他涉及查看 Devnet 的任务。本地验证器对于开发中的快速迭代来说很好，所以我们以后可以使用它。

⚠️ Windows 用户： 我使用的是 MacOS 和 Linux，但是 Windows 用户可以/应该使用 Windows Subsystem Linux (WSL) 和 Solana CLI（Solana 开发者推荐）。Solana CLI 安装说明中有一个部分解释了 Windows 用户的更多详细信息。请看：“Windows Subsystem Linux (WSL)”

安装 NVM/FNM、Node.js、PNPM、Rust（必需）。
安装 Solana CLI。
为 Devnet 配置 CLI。
创建一个 Devnet 钱包。
通过空投获得免费的 Devnet SOL。
用于获取信息的基本 CLI 命令。
用于交易的 CLI。
在 Solana Explorer 上查看：Solscan.io (devnet)
Solana Toolkit / “Mucho”（新的 CLI 助手）
🥷🏻秘密 Solana CLI 命令（奖励）
其他 Solana 资源

📝 关于 Solana Devnet 的一些快速说明：

免费使用。 Solana Devnet 不需要真正的 SOL，因此你可以安全地进行实验而无需花钱。
相同的运行时。 它的行为几乎与 Solana Mainnet 完全相同，使其成为真实世界测试的理想选择。
公共水龙头。 请求免费的测试 SOL 来资助你的 Devnet 钱包。
干净的重置。 网络会定期重置，因此不要期望长期的数据持久性。
非常适合调试。 交易日志和程序输出在 Devnet 上更容易跟踪和调试。
可在 Solana 浏览器中查看。 你可以在 Solana 区块链浏览器中查看你的交易。只要确保将其切换到 Devnet！

缺点，请注意以下几个缺点：

空投速率受限制，有时会延迟。 你无法立即从 devnet 获得 100 个 dev SOL。通常每小时（或更长时间）只有 1-2 个 SOL，因此你必须尝试少量 SOL。而且，如果你使用 VPN 代理或默认的 devnet url，则更容易受到速率限制。本文下面有一些关于如何处理此问题的建议。可以说，有时这可能有点痛苦。
在极少数情况下，Devnet 的性能可能会降低。 它是用于开发者测试和实验的，这可能会导致一些问题，从而在一段时间内降低效率。

1. 安装 nvm/fnm, Node.js (必需)

首先，我们需要在下面的这些步骤中安装 Solana CLI 的 Node.js 要求。nvm 和 fnm 是更改 Node.js 版本的方法。在本教程系列开始之前，这是必需的。 注意：nvm 是一种更流行的选择；fnm 是更新的，类似于 nvm，但在跨平台方面更广泛可用。

⚠️ Windows： 必须使用 Windows Subsystem Linux (WSL) 才能使用 Solana CLI。Solana CLI 安装说明中有一个部分。请看：“Windows Subsystem Linux (WSL)”

我试图简化下面的说明，但如果你需要进一步的参考或遇到错误，请查看：Solana 文档说明以获取更多信息：https://solana.com/docs/intro/installation

1.1 — 验证是否已安装 Node.js (必需)

nvm 是 Node.js 版本管理器， 允许你在 MacOS 上安装和切换多个 Node.js 版本。FNM (Fast Node Manager) 在 Windows 上执行此操作。

Node.js 用于运行我们需要执行的各种命令、脚本和安装程序。你使用 NVM 来安装 Node.js 版本。 如果你没有安装它，我们将无法走得很远 — 所以请确认已安装。

检查你的命令行中是否安装了 Node：

1. 确认已安装 Node.js

node -v

## 输出，如果成功，版本可能会有所不同

v22.14.0

2. 确认已安装 NVM 或 FNM（此处的示例是 MacOS NVM，对于 Windows 请使用 fnm — version）

nvm -v

## 输出，如果成功，版本可能会有所不同

0.39.0

3. 确认已安装 pnpm — 像 npm 但速度快得多

pnpm -v

## 输出，如果成功，版本可能会有所不同

8.15.7

4. 确认已安装 Rust。

rustc --version

## 输出，如果成功，版本可能会有所不同

rustc 1.85.0 (4d91de4e4 2025-02-17)

在上面的示例中，我在 MacOS 上安装了全部 4 个。

查看安装

如果任何一个未安装， 你将收到错误或没有版本信息。

如果一切都适合你， 请继续下面的 “2. 安装 Solana CLI” 步骤
如果某些或所有都 没有 工作， 请转到下一步 1.2 安装它们。
如果你只需要 pnpm ，运行下面的安装，然后跳至 “2. 安装 Solana CLI” 步骤
如果你只需要 Rust， 你可以转到步骤 1.3 中的相应部分。

## 下载并安装 pnpm：
corepack enable pnpm

## 验证 pnpm 版本：
pnpm -v

🙋‍♂️ 我们需要 pnpm 吗？ 是的，它比 npm 快。如果你熟悉 npm，请以完全相同的方式使用它，只需改用 pnpm 即可。如果由于某种原因你绝对不能这样做，那么使用 npm 应该也可以，但是我的示例将尽可能坚持使用 pnpm，因此你必须翻译一下。

🙋‍♂️ 我们需要 nvm OR fnm 吗？ 是的，你应该根据你的系统安装其中一个。有时你可能需要切换 Node.js 版本才能进行我们的工作。

1.2 — 安装 nvm/fnm、Node.js、pnpm、Rust（如果需要）

我们将安装 nvm 或 fnm、Node.js 和 pnpm（三个安装）。

有几种安装方法。

我在下面列出了我推荐给 MacOS 和 Windows 的方法，但是你可以通过此处的链接更改一些设置：可配置的安装说明，具体取决于你的操作系统（Windows、MacOS、Linux 等）等几个选项。

可配置的安装说明

安装 MacOS 版本、Node.js 22、nvm、pnpm：

## 下载并安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

## 代替重启 shell
\. "$HOME/.nvm/nvm.sh"

## 下载并安装 Node.js：
nvm install 22

## 验证 Node.js 版本：
node -v # 应该打印 "v22.14.0"。
nvm current # 应该打印 "v22.14.0"。

## 下载并安装 pnpm：
corepack enable pnpm

## 验证 pnpm 版本：
pnpm -v

安装 Windows 版本、Node.js 22、fnm 、pnpm：

## 下载并安装 fnm：
winget install Schniz.fnm

## 下载并安装 Node.js：
fnm install 22

## 验证 Node.js 版本：
node -v # 应该打印 "v22.14.0"。

## 下载并安装 pnpm：
corepack enable pnpm

## 验证 pnpm 版本：
pnpm -v

1.3 — Rust 安装

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

更新你的路径，以便它在你的终端中连接：

. "$HOME/.cargo/env"

检查版本：

rustc --version

2. 安装 Solana CLI

Solana CLI 由 Anza (anza.xyz) 维护，该公司从 Solana Labs 接管了维护工作。我们下载最稳定的版本。

CLI 就像一把瑞士军刀，可以从你的本地计算机或服务器快速完成任务。例如，如果你想检查一个帐户、进行快速手动交易或获取信息。

要安装 CLI，请打开一个终端并运行：

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

你可能会收到一些其他消息，如果是这样但不确定该怎么做，请查看更多详细信息：https://solana.com/docs/intro/installation#install-the-solana-cli

2.1 — 将 CLI 添加到我们的 PATH（将其连接到你的终端）

你可能需要重新启动终端才能生效。

Linux 和 Windows WSL 用户：

export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"

仅限 MacOS：

echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc

source ~/.zshrc

2.2 — 通过获取 Solana 版本来测试它。

solana --version

## 输出，版本可能有所不同

solana-cli 2.1.16 (src:a5744e79; feat:3271415109, client:Agave)

🥷🏻 ✅ 我们完成了 CLI 安装。

如果你需要帮助进行故障排除， 请首先查看 Solana CLI 安装文档，并且你也可以在 Solana Stack Exchange 上提问。

你也可以在评论中提问。我会尽力提供帮助，或者其他人可能会知道！

3. 为 Devnet 配置 CLI

Devnet 是我们将要玩耍的地方 — 让我们将 CLI 指向那里。

这将配置 Solana CLI，以便 Solana CLI 知道我们在发送交易或检查帐户时专门使用 Devnet。否则，我们必须在说明中说明。

配置完成后，你无需在每个命令中指定网络。

设置网络：

solana config set --url https://api.devnet.solana.com

solana config set --url https://api.devnet.solana.com

## 输出，注意：这可能略有不同，
## 此示例的关键部分是 RPC URL：https://api.devnet.solana.com

Config File: /path/.config/solana/cli/config.yml
RPC URL: https://api.devnet.solana.com
WebSocket URL: wss://api.devnet.solana.com/ (computed)
Keypair Path: /Users/[你的用户名]/.config/solana/wallet.json
Commitment: confirmed

此命令的其他 CLI 選項：

solana config set — config <FILEPATH> ←url <URL_OR_MONIKER>| — ws <URL>| — keypair <KEYPAIR>| — commitment <COMMITMENT_LEVEL>>

Config File: /Users/[你的用户名]/.config/solana/cli/config.yml

保存这些设置的配置文件在你计算机上的路径。此 YAML 文件存储你的 CLI 首选项（如 URL 和钱包）。它隐藏在你主目录下的 .config/solana/cli/

RPC URL: https://api.devnet.solana.com 远程过程调用 URL，你的 CLI 用于与 Solana 区块链通信的地址。这证实了你的所有操作（如空投）都发生在 Devnet 上，而不是 mainnet 或 testnet 上。
WebSocket URL: wss://api.devnet.solana.com/ (computed) CLI 从 RPC URL 自动生成此 URL（将 https 替换为 wss）。 WebSockets 允许你侦听事件。现在无需担心。
Keypair Path: /Users/[你的用户名]/.config/solana/wallet.json 你的钱包密钥对文件的位置，该文件保存你的公钥和私钥。请保密。 如果泄露，这是一个安全风险。 不要将此未加密地保存在你的本地 PC 上以用于真正的生产 mainnet。但是，对于开发，我们将这样做，因为我们使用的是假的 dev SOL。
Commitment: confirmed “Confirmed” 表示一旦大多数节点同意交易有效（在 Devnet 上大约 1-2 秒，速度很快），CLI 就会认为交易已完成。存在其他选项，例如 “finalized”（速度较慢，但更确定），但这是默认设置。这可能会影响你的游戏或操作感觉响应的速度 — 目前速度越快越好。

验证配置：

solana config get（应显示 Devnet URL）。

这只是获取上面配置中输入的相同信息。也许你忘记了你的设置是什么。

检查集群状态：

solana cluster-version（确认连接）。

这只是确认我们已连接。

如果存在连接问题，它将返回错误。

4. 创建一个 Devnet 钱包

我们正在创建一个 Solana CLI 文本钱包， 如果你以前没有这样做过，那么这可能与你期望的不同。

CLI 钱包 意味着钱包保存在你的本地文件系统中，而不是像你可能习惯的那样在浏览器中。我有目的地这样做是为了你的学习，因为这是理解某些内容所必需的。
大多数人熟悉像 Phantom 或 Backpack 钱包这样的 Chrome 钱包。 这执行相同类型的任务，但它只在 CLI 上，而不是在你的 Chrome 浏览器中，没有颜色和 UI。
在下一个教程中，我们将使用 Chrome 钱包 并且会更多地讨论它。但在这种情况下，它只是你本地文件系统上的一个特殊文本文件。
⚠️ 重要提示：此类型的钱包文件未加密。因此，如果有人窃取了此文件，他们将拥有你所有的 SOL、代币、钱。 仅将其与 devnet SOL（假的）一起使用，不要在此处放入真正的 SOL。即使是一些顶级的 Solana 开发者也曾有 CLI 钱包被盗的情况。此文件存在安全风险，因此不建议使用，除非用于我们使用假的 devnet SOL 进行学习/演示目的。

4.1 — 生成钱包密钥对

当你创建钱包时，它会有一个公钥和一个私钥（密钥），因此，它被称为 “密钥对”。此文件应保密，切勿泄露。

在下面创建它的命令中，你可以更改名称 dev-wallet.json 和绝对文件路径为你想要的任何内容。我将为示例使用 wallet-dev.json，并且路径取决于你的系统，因此请将你的路径替换为 /path/to/file

solana-keygen new --outfile /path/to/file/wallet-dev.json

🥷🏻 输出（示例）：

生成一个新的密钥对

为了增加安全性，请输入一个 BIP39 密码

注意！ 此密码提高了恢复**加粗**种子短语**加粗**的安全性，**加粗**而不是密钥对文件本身的安全性，该文件存储为不安全的纯文本

BIP39 密码（如果不需要密码则留空）：

已将新的密钥对写入 /path/to/file/wallet-dev.json
================================================================================
公钥：GtYM8YsjXCy2t9WqAgUbuWUpQYAxBLrT2r4u7G1F2S3p
================================================================================
保存此种子短语和你的 BIP39 密码以恢复你的新密钥对：
[这里将出现随机词，总共十二个，请保密]

对于开发/学习，请将密码留空。通常在开发中不使用密码。
公钥： 列出的是公钥。 它不是秘密。 你可以将其提供给其他人进行付款或向你转账代币，并且可以键入以获取公共帐户信息。此处列出的公钥格式如下：

GtYM8YsjXCy2t9WqAgUbuWUpQYAxBLrT2r4u7G1F2S3p

密钥对文件：以二进制格式包括 私钥和公钥。

这是一个未加密的密钥文件，我们仅用于开发学习。请勿泄露它，因为它包含你的私钥。 这也是在你的笔记本电脑上（未加密）拥有该文件存在安全风险的原因，恶意软件可能会窃取该文件。但是，我们仅将此钱包用于开发（开发代币）。请勿在 Solana mainnet 上或在生产中使用它来存放真钱或真代币。

私钥：是一个秘密。 请勿泄露。可以从密钥对文件中提取此密钥。如果有人获得此密钥，他们将完全访问你的钱包，并且可以 “耗尽”（从钱包中移除所有代币）。
“保存此种子短语”：这是一个用于恢复的助记词。请勿泄露。 给出的短语将是 12 个单词（“ BIP39 短语”，是短语标准 ），可以用于恢复钱包。如果其他人获得此短语，他们将完全访问你的钱包。

请记住：你可以选择路径 / 目录，并将钱包文件命名为你想要的任何名称和 .json，我只是在此使用 “wallet-dev”。

4.2 — 确认钱包设置和激活

验证你的密钥

solana-keygen verify &lt;PUBKEY> /path/to/file/wallet-dev.json

输出：

验证公钥 GtYM8YsjXCy2t9WqAgUbuWUpQYAx....：成功

查看你当前的钱包，默认钱包：

solana address

对于我来说，我使用了其他钱包，因此即使我创建了上面的钱包，第一次 solana address 也给了我一个不同的公共地址。

原因是，我必须设置新钱包，我的旧钱包仍然设置为活动钱包。

4.3 — 设置活动钱包

如果你需要更改哪个钱包对你处于活动状态。

solana config set --keypair &lt;/path/to/file>/wallet-dev.json

## 输出：

Config File: /path/.config/solana/cli/config.yml
RPC URL: https://api.devnet.solana.com
WebSocket URL: wss://api.devnet.solana.com/ (computed)
Keypair Path: /path/to/file/wallet-dev.json
Commitment: confirmed

我们之前设置了 devnet
我们看到 Keypair Path 现在是正确的，它指向我们的新钱包。

再次确认地址

solana address

## 输出
GtYM8YsjXCy2t9WqAgUbuWUpQYAx....

🥷🏻 ✅ 是的，现在该地址是我们新创建的钱包的公钥。

5. 通过空投获得免费的 Devnet SOL

我们需要免费的 devnet SOL。在这一点上，除了检查信息之外，我们无法使用 CLI 做很多事情，因为钱包没有 SOL。

但是，我们可以获得 dev SOL 的 “空投”，然后开始进行一些交易。

devnet 上的 SOL 不是真正的 SOL，因此无法在实时主网上出售。

⚠️ 在执行空投之前，请注意：

如果你在使用 VPN 或共享 IP，它可能无法正常工作， 因为如果许多人从同一 IP 发出请求，它将限制速率并阻止。因此，如果它给你一个错误，这是首先要考虑的事情。
此外，它受到速率限制， 你不能只是不断地请求无限量。 通常，你可以每隔几分钟或一个小时执行 2 SOL，但是 如果网络繁忙，有时数量会更少。
如果你因超时或速率限制而收到错误。 请稍等片刻，然后重试。或者尝试下面讨论的其他方法。
⚠️ 且不要浪费 dev SOL。 它是免费的，但是有时可能存在速率限制或其他问题，导致你无法获得更多 SOL。尝试积累一些 SOL，这样如果发生延迟，你就不会耗尽。

空投：

solana airdrop 1

## 错误输出 - 如果你收到速率限制错误
Error: airdrop request failed. This can happen when the rate limit is reached.

我遇到了错误。有时会发生这种情况。

通常，如果你使用第三方 RPC url/api 密钥，你会做得更好（我们使用的是默认的 devnet RPC，它受到了很多开发者的slam）。如果你想从 Helius 获得一个 RPC 密钥，请参阅我的文章：Building on Solana: Helius RPCs + Tutorial 。或者，请按照以下说明获取 Web 开发代币水龙头。

如果你使用 Helius，这非常容易，你只需将我们之前为网络所做的配置更改为你获得的 Helius url 即可。

如果这不起作用，你可以使用官方 Solana.com “水龙头”：

每 8 小时最多两个请求
我连接了我的 Github（仅用于电子邮件/个人资料）， 并且我在 dev 中获得了 5 SOL，这是一个不错的数量。

https://faucet.solana.com/

✅ “空投成功”

使用以下命令检查你的余额：

## 空投之前

$ solana balance
0 SOL

## 空投之后

$ solana balance
5 SOL

6. 用于获取信息的基本 CLI 命令（信息，时间）

我们可以执行许多其他基本命令来获取信息，这些信息可能因各种原因而有用。

让我们快速执行几个信息类 CLI 命令，以确保一切正常。这是一个快速的胜利！

获取 Solana 区块时间，它显示了 Devnet 上最新区块的时间戳。

solana block-time

## 输出

Block: 368007187
Date: 2025-03-17T18:50:11Z

🥷🏻 block-time 的可能用例：

实时游戏触发器。
游戏的随机数种子。
交易基准计时。
与时间同步的实时事件。

你也可以获取 Solana epoch：

solana epoch-info

## 输出
```区块高度: 355993994
槽位: 368014511
纪元: 851
交易计数: 15336116514
纪元槽位范围: [367632000..368064000)
纪元完成百分比: 88.544%
纪元已完成槽位: 382511/432000 (剩余 49489)
纪元已完成时间: 1天 16小时 57分 45秒/1天 22小时 15分 18秒 (剩余 5小时 17分 33秒)

🥷🏻你可以通过编程方式获取这些信息，例如：

如果你想让一个特殊事件（比如奖品掉落）每个纪元发生一次，可以在游戏中使用。
跟踪 staking 奖励何时可能归属。
网络健康检查。
跟踪其他基于时间的竞赛或事件。

跟踪 SOL 的供应量（记住：如果你配置了，这是用于 devnet 的）

solana supply

## output

Total: 1280289349.0014498 SOL
Circulating: 964424387.3256116 SOL
Non-Circulating: 315864961.67583805 SOL

🥷🏻 你只需输入 solana 并回车，就可以获得完整列表

solana

## output

 account                              显示账户内容
 address                              获取你的公钥
 address-lookup-table                 地址查找表管理
 airdrop                              从水龙头请求 SOL
 authorize-nonce-account              将账户权限分配给新的实体
 balance                              获取你的余额
 block                                获取已确认的区块

... etc

7. 交易的 CLI，在 Solscan.io 中查看

我们可以进行 token 的转移，通过发送到另一个公有地址来轻松验证 wallet 是否正常工作。你甚至可以从你的 wallet 发送到你自己的 wallet —— 它仍然会被注册为一次转移！

此外，我们预计余额会略有减少，因为所有交易都有网络费用。

首先，获取一个可以检查的公有地址。你甚至可以使用你自己的地址，然后像这样再次获取：

solana address

## output, 示例我的地址
GtYM8YsjXCy2t9...

现在让我们进行一次转移到你想检查的公有地址，甚至是我们自己（我试过了，它有效！）：

## transfer
solana transfer &lt;PUBLIC_ADDRESS> 0.01 --no-wait

## output, 你的交易会不同
Signature: 2DJe8mZg7Pwbxx4RzN3oE3TJiGMr1nCo87zgvY1M67eZ2...

## check balance
solana balance
4.999995 SOL

✅ 我们将 .01 SOL 发送到了公有地址。如果你使用了你自己的地址，你也可以这样做！它不再是 5 了，因为有一个小的网络交易费用，所以它是 4.999995 SOL。

我们稍后会使用 Signature，所以请保留它。

8. 在 Solscan.io 区块浏览器中查看

Solscan.io 是 Solana 区块浏览器的其中之一。 我们将在某个时候深入研究区块浏览器，它们非常吸引人，但这将在以后的教程中进行！我们只是想检查我们的交易是否在那里。

现在就去那里： https://solscan.io/

Solana 区块浏览器， 为你提供关于区块链上的交易、token、NFT 或账户的所有详细信息，以及额外的 info，例如账户的交易历史等等。

如果你从未用过或者更改过它，它默认使用 mainnet (live Solana) 进行所有查找。

由于我们使用的是 Devnet 而不是 mainnet，我们需要切换它以使用 Devnet 进行搜索。

点击 Solana 徽标，点击它以打开下拉菜单 并切换到 Devnet。

例如，见红色框：https://solscan.io/

我从之前复制了交易签名并将其粘贴到搜索栏中。

注意，它说 Transaction (1)，找到了。

立即在下拉菜单中找到。

我点击了那个搜索结果。

🥷🏻 ✅ 现在，我确认下面这些

我在 Devnet 上，
对于我输入的签名 2DJe8m…
我的交易在 16 分钟前处理了，
我的 wallet GtYM8Y… 签署了交易
交易是在我自己的 wallet GtYM8Y… 和我的 wallet GtYM8Y 之间进行的。
这是一笔 0.01 SOL 的转移。

其他 Solana 区块浏览器

我不想给你留下 Solscan 是唯一区块浏览器的印象，还有很多其他的，有些人更喜欢其他的，因为它们可能提供额外的功能。

其他流行的：

Solana Explorer

https://explorer.solana.com/

Solana.FM

https://solana.fm/

Helius Orb (formerly Xray, in Beta)

https://orb.helius.dev/?cluster=mainnet-beta

这些只是一些。

9. Solana Toolkit / “Mucho” (新的 CLI 助手)

有一个全新的库叫做 Solana Toolkit (aka “Mucho” library)，它是 CLI 的一个包装器。它应该使 CLI 的一些事情更容易，并且是为开发者构建的。它最近才发布。

由于它很新，我没有广泛使用过。 事实上，直到我写到这篇文章的这一点，我甚至不知道它的存在 🤣。

它看起来很有用，但这只是一个介绍，让你知道它的存在。它处于 Beta 阶段。此外，它还试图安装一些其他的依赖项。有些我有，有些我没有。所以它可能需要几分钟才能安装。

GitHub - solana-foundation/mucho: Command-line tool that simplifies the development and testing of… \ \ Command-line tool that simplifies the development and testing of Solana blockchain programs. - solana-foundation/mucho \ github.com

这是一个必需的工具吗？不，它是一个可选的，但有用的工具包，它可能会帮助你，但如果你无法安装它，你可以在 repo 上询问你需要帮助的任何事项。我有一个小故障（一个警告错误），然而，在那之后它确实工作了，而我没有做任何调试（就我目前所知）

“This is a beta version of the Solana Toolkit, and is still a WIP. Please post all feedback as a GitHub issue here.”

你可以像这样安装它: npx -y mucho@latest install

npx -y mucho@latest install

## output

mucho update available - v0.9.0
   To install the latest version, run the following command:
   npx mucho@latest self-update

 Install Solana development tools
✔ mucho 0.9.0 installed
ℹ rust 1.85.0 is already installed

来自文档：

install - 在你的系统上安装和管理 Solana Toolkit 的本地开发工具。
clone - 从任何想要的 Solana 集群克隆账户和程序（又名 fixtures），并在 Solana.toml 中声明。
validator - 在你的本地机器上运行 solana-test-validator，包括为你 repo 加载所有克隆的 fixture。
build - 构建你的工作区中的所有或单个 Solana 程序。
deploy - 部署你的工作区中的 Solana 程序。
coverage - 在 Solana 程序上运行代码覆盖率测试。
info - 收集关于你的设置的有用的故障排除信息。
docs - 显示 Solana 开发工具的文档。
balance - 获取所有集群的账户余额。
inspect - 在 CLI 中检查交易、账户和区块（像区块浏览器）

获取版本：

mucho --version

## output

mucho 0.9.0
rustc 1.85.0 (4d91de4e4 2025-02-17)
node v22.14.0
solana-cli 2.1.16 (src:a5744e79; feat:3271415109, client:Agave)
solana platform tools:
  build-sbf: 2.1.1
  platform-tools: 1.43

你可以像这样获取关于你的系统的信息：

npx mucho info

## output

--- start mucho info ---
System Info:
[你的系统信息]
------------------------
Installed tooling:
  rustup: 1.28.1
  rust: 1.85.0
  solana: 2.1.1
  avm: 0.30.0
  anchor: 0.30.1
  node: 22.14.0
  yarn: 1.22.2
  trident: false
  zest: false
  cargo-update: 16.2.0
  verify: false
------------------------
Platform tools:
  build-sbf: ---
  platform-tools: ---
------------------------
Solana CLI info:
  Config File: [路径]/.config/solana/cli/config.yml
  RPC URL: https://api.devnet.solana.com
  WebSocket URL: wss://api.devnet.solana.com/ (computed)
  Keypair Path: [路径]/wallets/wallet-dev.json

  Commitment: confirmed
Does CLI config.yml exist: true
Address: G....
Balances for address:
  devnet: 4.9995 SOL
  mainnet: 0 SOL
  testnet: 0 SOL
  localnet: false
Is test-validator running? false
Localnet url: http://127.0.0.1:8899
---- end mucho info ----

我有点想现在就开始介绍 token 的创建，但我们稍后再说！

我自己已经用 CLI 做了好几次了，但也许下次我们会使用 mucho