solana-cli 工具如何升级到最新版本

本文修改于：2025 年 4 月 20 日

安装agave-install 工具：

要安装 agave-install 工具，以便使用它来安装或升级 Solana CLI，可以按照以下步骤操作。以下是简洁的安装指南：

1. 下载并运行安装脚本：

使用以下命令从 Anza 官方服务器下载并执行 agave-install 的安装脚本：bash

arduino 复制代码

curl -sSfL https://release.anza.xyz/stable/agave-install-init.sh | sh

这会下载最新稳定版本的 agave-install 和 Solana CLI，并将其安装到默认路径（通常为 ~/.local/share/solana/install/active_release/bin）。
stable 表示稳定版本通道。如果需要其他版本（例如 beta 或特定版本如 v2.2.6），可以替换 stable 为所需版本号或通道，例如：

bash 复制代码

curl -sSfL https://release.anza.xyz/v2.2.6/agave-install-init.sh | sh

2. 添加到 PATH：

安装完成后，需要确保 agave-install 和 solana 命令在你的 PATH 中。运行以下命令：

bash 复制代码

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

为确保永久生效，将此行添加到你的 shell 配置文件（例如 ~/.bashrc 或 ~/.zshrc）：

bash 复制代码

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

3. 验证安装：

检查 agave-install 和 Solana CLI 是否正确安装：

css 复制代码

agave-install --version
solana --version

如果命令返回版本号，说明安装成功。

注意事项

系统要求：agave-install 适用于 Linux 和 macOS。Windows 用户建议使用 WSL（Windows Subsystem for Linux）。
权限问题：如果遇到权限错误，确保你有权限写入 ~/.local/share/solana 目录，或者尝试以 sudo 运行安装命令。
网络问题：若下载脚本失败，检查网络连接或尝试使用代理，确保能访问 release.anza.xyz。

4. 如何升级：

要升级 agave-install 工具以及相关的 Solana CLI（Agave），

运行更新命令：使用 agave-install update 命令来升级到最新版本：

sql 复制代码

agave-install update

此命令会检查 GitHub 上最新的稳定版本（默认 stable 通道），下载并更新 agave-install 和 Solana CLI。
如果你需要升级到特定版本（例如 v2.2.6），可以运行：

csharp 复制代码

agave-install init v2.2.6

验证升级：升级完成后，检查 agave-install 和 Solana CLI 的版本以确认更新成功：

css 复制代码

agave-install --version
solana --version

升级 solana cli 工具

1. 检查当前版本

首先，检查你当前安装的 solana-cli 版本：

css 复制代码

solana --version

这将显示类似以下输出：

less 复制代码

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

2. 更新到最新版本

Solana 的 CLI 可以通过 agave-install update 命令直接更新到最新版本。执行以下命令：

sql 复制代码

agave-install update

这会自动从 GitHub 的 Anza 仓库（https://github.com/anza-xyz/agave）下载并安装最新的稳定版本。
更新完成后，你可能会需要重新加载终端环境变量，或者重启终端。

如果已经更新到了最新的版本，终端输入上述的命令会打印如下信息

vbnet 复制代码

Install is up to date. a5744e7 is the latest commit for stable

3. 验证更新

更新完成后，再次检查版本以确认是否成功升级：

css 复制代码

solana --version

输出版本号应反映最新的稳定版本（例如 2.1.16 或更高版本，取决于当前最新发布）。

4. 指定特定版本（可选）

如果你不想安装最新版本，而是想升级到某个特定版本，可以使用以下命令：

swift 复制代码

agave-install init <版本号>

例如：

csharp 复制代码

agave-install init v1.18.25

这将安装指定的版本。

5. 确保 PATH 配置正确

安装或更新后，确保 Solana 的二进制文件路径已正确添加到你的环境变量 PATH 中。通常，安装程序会自动处理，但如果 solana 命令无法识别，可以手动添加：

Linux/MacOS：

编辑 ~/.bashrc 或 ~/.zshrc，添加：

bash 复制代码

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

然后运行：

bash 复制代码

source ~/.bashrc  # 或 source ~/.zshrc

6. 遇到问题时的解决方法

命令未找到 ：如果 agave-install 不可用，可能是因为你使用的是较旧的安装方式（例如通过 solana-install）。在这种情况下，可以先卸载旧版本并重新安装：

bash 复制代码

# 卸载旧版本
rm -rf ~/.local/share/solana/install
# 重新安装最新版本
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

网络问题 ：确保你的网络可以访问 release.anza.xyz。