Solana CLI 快速入门指南:开发者的五分钟上手路线

·

了解 Solana 的核心理念后,动手环节绕不开 Solana CLI。本文围绕“如何配置 Solana CLI如何创建钱包并领取测试网 SOL如何在本地启动测试验证器”等技术关键词展开,用极简命令行操作,帮你把开发流程跑通。无论你是初探 Solana,还是刚准备写第一段智能合约,跟着下面的 6 个步骤动手即可。


1. 创建 Solana 钱包:命令不到 10 秒

在部署程序或交互合约之前,先准备钱包。这里用文件系统钱包,把私钥存成单个 .json,方便 CLI 直接读取。

solana-keygen new --outfile ~/.config/solana/dev-wallet.json

执行后会显示:

屏幕上出现提示时,务必设置一个高强度密码。后续若用同一钱包上主网,这一步就是最后的安全堡垒。

⚠️ 安全提示:把助记词抄到离线纸质笔记本,别截图,更别存网盘。


2. 核查当前配置:别让 CLI 连错 RPC

钱包有了,还要确保 CLI 指向正确网络。输入:

solana config get

示例输出:

Config File: ~/.config/solana/cli/config.yml
RPC URL: https://api.testnet.solana.com
Keypair Path: ~/.config/solana/id.json
Commitment: confirmed

想偷懒?直接 CLI 一步改齐:

solana config set --url localhost --keypair ~/.config/solana/dev-wallet.json

3. 更新网络与钱包配置:一行命令切换环境

在项目迭代过程中,经常要在 devnet ↔ testnet ↔ localnet 之间跳转,命令只有两行:

# 切换到 devnet
solana config set --url devnet
# 切换自定义 RPC 节点
solana config set --url https://your-own-rpc.com

钱包亦同理:

solana config set --keypair ~/.config/solana/another-wallet.json

改完再 solana config get 核验。切换网络这件事,越熟练越省 debug 时间。


4. 查看余额:先确认兜里有没有测试 SOL

交交易要 SOL 余额,否则寸步难行。

# 查当前配置钱包余额
solana balance
# 查任意地址
solana balance <9x...地址>

输出单位为 SOL,三位小数就够用了。如果为 0,别慌——继续下步领取空投。


5. 测试网空投 获取 SOL:三分钟搞定 Gas 费

在 devnet/testnet,开发者可以免费领取 测试代币,生产环境的主网则不行。

1) CLI 直接申请:

solana airdrop 2

一次上限 2 SOL,不够就多打几次。

2) 公共水龙头:

打开浏览器,👉 一个无需注册的 Solana 空投水龙头,2秒内到账,输入地址点一下即可。

常见问题


6. 启动本地测试验证器:升级开发体验的关键一步

上线前,先在本地跑 solana-test-validator,能显著节省反馈时间。

solana-test-validator

启动后,本地节点会:

配套命令:

# CLI 连接本地网络
solana config set --url localhost
# 立即领取 10 SOL,不限量
solana airdrop 10

体验过本地链的丝滑,你会永远告别排队等待 RPC。


进阶:Solana CLI & Anchor 的无缝协作

如果你已安装 Anchor Framework,Anchor CLI 会直接复用 Solana CLI 设定的 network 与 keypair。换言之,上述所有步骤都能一体生效——这就是“工具一致”带来的幸福感:


情景案例:实战演练全流程

假设准备把 NFT Mint 合约搬到 devnet,全程不到 1 分钟:

  1. 建钱包
    solana-keygen new --outfile dev.json
  2. 切 devnet
    solana config set --url devnet --keypair dev.json
  3. 空投
    solana airdrop 2
  4. 本地验证逻辑
    启动 solana-test-validatorsolana program deploy <program.so>
    跑单元测试 OK → 切回 devnet → anchor deploy

整个过程 完全复用同一套命令格式,学会了就一通百通。


FAQ:读者最关心的 5 个问题

Q1:为什么我执行 solana airdrop 3 报错?
A:devnet 单次限额 2 SOL,分成两次即可。

Q2:私钥文件被别人复制,钱包能救回来吗?
A:立刻用助记词在离线电脑生成新钱包,把资产全部转走,原钱包作废。

Q3:本地验证器的区块高度一直为 1,这正常吗?
A:正常。localnet 只有你一个节点在出块,因此区块高度缓慢递增。

Q4:如何把 CLI 转为中文界面?
A:solana-cli 暂未提供官方中文选项,可全局装中文 alias 或 wrap 脚本,但并不推荐。

Q5:测试网与主网的 RPC 速度差距有多大?
A:测试网背靠 Solana Lab 维护,延迟通常低于 200 ms;主网受网络拥堵影响,时延可到 700–1000 ms。


结语

创建钱包配置 RPC领取测试 SOL启动本地链,掌握 Solana CLI 只需十来条命令。下一步,你就可以把精力全部放在合约逻辑本身。祝开发顺利,别忘了把本文收藏为常备备忘。

👉 点这查看 5 分钟部署 Solana 程序的极简脚本合集