**本文档仅适用于 AWS CLI 版本 1。**

我们已宣布即将终止对 AWS CLI 版本 1 的支持。建议您迁移到 AWS CLI 版本 2。有关日期、其它详细信息以及如何迁移的信息，请参阅[公告](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)。有关 AWS CLI 版本 2 的相关文档，请参阅[版本 2 用户指南](https://docs.aws.amazon.com/cli/latest/userguide/)。

# 在 Linux 上安装、更新和卸载 AWS CLI 版本 1
<a name="install-linux-al2017"></a>

AWS CLI 版本 1 已预安装在 Amazon Linux 和 Amazon Linux 2 上。使用以下命令检查当前安装的版本。

```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```

根据您创建 Amazon Linux 实例的时间，使用下列程序包管理器之一来预安装 AWS CLI 版本 1：
+ [pip](#install-amazon-linux-pip)：
+ [yum](#install-amazon-linux-yum)

## 先决条件
<a name="install-amazon-linux-prereq"></a>

您必须已安装 Python 3.8 或更高版本。有关安装说明，请参阅 Python 的*初学者指南* 中的[下载 Python](https://wiki.python.org/moin/BeginnersGuide/Download) 页面。

**Python 版本支持矩阵**


| AWS CLI version | 支持的 Python 版本 | 
| --- | --- | 
| 1.39.0 – 当前 | Python 3.9\$1 | 
| 1.32.0 – 1.38.38 | Python 3.8\$1 | 
| 1.27.0 – 1.31.x | Python 3.7\$1 | 
| 1.20.0 – 1.26.x | Python 3.6\$1 | 
| 1.19.0 — 1.19.x | Python 2.7\$1、Python 3.6\$1 | 
| 1.17 – 1.18.x | Python 2.7\$1、Python 3.4\$1 | 
| 1.0 – 1.16.x | Python 2.6 及更早版本，Python 3.3 及更早版本 | 

## 使用 pip 进行安装、更新和卸载
<a name="install-amazon-linux-pip"></a>

 大多数 Amazon Linux 实例都使用 pip 来预安装 AWS CLI 版本 1。

### 使用 pip 在 Amazon Linux 上安装或更新 AWS CLI 版本 1
<a name="install-amazon-linux-pip-install"></a>

要为当前用户安装最新版本的 AWS CLI 版本 1，请按以下说明操作。

1. 如果您安装了 Python 3 或更高版本，我们建议您使用 `pip3`。使用 `pip3 install` 安装或更新至 AWS CLI 版本 1 的最新版本。如果您在 [Python 虚拟环境 (venv)](https://docs.python.org/3/library/venv.html) 中运行命令，则不需要使用 `--user` 选项。

   ```
   $ pip3 install --upgrade --user awscli
   ```

1. 确保包含 `aws` 的文件夹是您的 `PATH` 变量的一部分。

   1. 在您的用户目录中查找 Shell 的配置文件脚本。如果您不能确定所使用的 Shell，请运行 `echo $SHELL`。

      ```
      $ ls -a ~
      .  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
      ```
      + **Bash** – `.bash_profile`、`.profile` 或 `.bash_login`
      + **Zsh** – `.zshrc`
      + **Tcsh** – `.tcshrc`、`.cshrc` 或 `.login`

   1. 在配置文件脚本末尾添加与以下示例类似的导出命令。

      ```
      export PATH=$HOME/.local/bin:$PATH
      ```

      此命令将路径（在本示例中为 `$HOME/.local/bin`）插入到现有 `$PATH` 变量的前面。

   1. 将配置文件重新加载到当前会话中，以使更改生效。

      ```
      $ source ~/.bash_profile
      ```

1. 要验证是否正在运行新版本，请使用 `aws --version` 命令。

   ```
   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
   ```

### 使用 pip 卸载 AWS CLI 版本 1
<a name="install-amazon-linux-pip-uninstall"></a>

如果需要卸载 AWS CLI，请使用 `pip uninstall`。

```
$ pip3 uninstall awscli
```

## 使用 yum 进行安装、更新和卸载
<a name="install-amazon-linux-yum"></a>

大多数 Amazon Linux 2 实例都使用 yum 来预安装 AWS CLI 版本 1。

### 使用 yum 在 Amazon Linux 上安装或更新 AWS CLI 版本 1
<a name="install-amazon-linux-yum-install"></a>

要安装 Amazon Linux 上提供的 AWS CLI 版本 1 的最新版本，请运行以下命令。

```
$ sudo yum install awscli
```

要更新到 Amazon Linux 上提供的 AWS CLI 版本 1 的最新版本，请运行以下命令。

```
$ sudo yum update awscli
```

要验证是否正在运行更高的版本，请使用 `aws --version` 命令。

```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```

### 使用 yum 卸载 AWS CLI 版本 1
<a name="install-amazon-linux-yum-uninstall"></a>

要卸载 AWS CLI，请使用 `yum remove`。

```
$ sudo yum remove awscli
```

## AWS CLI 安装和卸载错误故障排除
<a name="install-amazon-linux-tshoot"></a>

如果您在安装或卸载 AWS CLI 后遇到问题，请参阅[排查 AWS CLI 错误](cli-chap-troubleshooting.md)以了解故障排除步骤。有关相关性最高的故障排除步骤，请参阅[找不到命令错误](cli-chap-troubleshooting.md#tshoot-install-not-found)、[“`aws --version`”命令返回的版本与您安装的版本不同](cli-chap-troubleshooting.md#tshoot-install-wrong-version)和[卸载 AWS CLI 后，“`aws --version`”命令返回一个版本](cli-chap-troubleshooting.md#tshoot-uninstall-1)。