WSL2 Ubuntu中AWS CLI v1升级v2失败及版本矛盾问题求助

问题原因 #

• PATH优先级冲突：系统中同时存在AWS CLI v1和v2的可执行文件，v1的路径在PATH环境变量中位置更靠前，导致执行aws命令时优先调用旧版本。
• 残留的v1安装：之前通过Ubuntu包管理器（如apt）安装的v1版本未被卸载，其可执行文件（通常在/usr/bin/aws）仍处于生效状态。
• Shell环境未刷新：安装v2后未重启shell或重新加载环境变量，旧的PATH配置仍在生效。

解决步骤 #

1. 定位当前aws命令的路径 #

先确认系统现在调用的是哪个版本的aws：

which aws

如果输出是/usr/bin/aws，说明当前用的是apt安装的v1；v2默认安装路径为/usr/local/bin/aws。

2. 解决PATH冲突 #

选项1：卸载apt安装的v1版本（推荐）

如果不需要保留v1，直接卸载旧版本：

sudo apt remove awscli
sudo apt autoremove

卸载完成后重启shell，执行aws --version即可验证v2是否生效。

选项2：临时调整PATH（仅当前会话生效）

若需临时切换到v2，将v2路径放到PATH最前面：

export PATH=/usr/local/bin:$PATH

执行后验证版本：

aws --version

选项3：永久调整PATH（所有会话生效）

编辑shell配置文件（比如~/.bashrc，若用zsh则编辑~/.zshrc）：

nano ~/.bashrc

在文件末尾添加：

export PATH=/usr/local/bin:$PATH

保存退出后，重新加载配置：

source ~/.bashrc

或直接重启shell，之后版本即可正常显示。

3. 验证v2安装完整性 #

如果上述操作后仍有问题，直接调用v2的可执行文件确认安装是否正常：

/usr/local/aws-cli/v2/2.15.27/bin/aws --version

若此命令能显示v2版本，说明安装没问题，只需重新调整PATH即可。

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