Linux下安装Anchor框架执行avm install latest报错的解决方法

1. 补全Anchor前置依赖 #

Anchor依赖Rust和Solana CLI，先确保这两个工具已正确安装并配置：

• 安装Rust：

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

  安装完成后执行source $HOME/.cargo/env，让Rust的环境变量立即生效。
• 安装Solana CLI：

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

  执行source $HOME/.bashrc（若用zsh则替换为source $HOME/.zshrc）更新shell环境变量。

2. 官方方式安装avm #

通过Cargo直接安装Anchor版本管理器（avm）：

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

3. 确认avm路径已加入系统PATH #

检查$HOME/.cargo/bin是否在系统可执行路径中：

echo $PATH

如果输出里没有这个路径，手动添加到shell配置文件：

# 针对bash用户
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
# 针对zsh用户
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc

执行source ~/.bashrc或source ~/.zshrc让配置生效。

4. 重新执行安装命令 #

现在再次运行以下命令即可完成Anchor最新版本的安装：

avm install latest
avm use latest

错误原因说明 #

终端列出的gvm/kvm等命令是系统中已存在的其他工具，本质是系统找不到avm命令，所以给出相近命名的工具作为提示。问题核心是avm未被安装，或其所在路径未加入系统可执行PATH。

内容的提问来源于stack exchange，提问作者CoolSaki