**本文件 AWS CLI 僅適用於 第 1 版。**

我們已宣布即將end-of-support。 AWS CLI 我們建議您遷移至 第 2 AWS CLI 版。如需日期、其他詳細資訊和如何遷移的資訊，請參閱 [公告](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)。如需 第 2 版的相關文件 AWS CLI，請參閱 第 [2 版使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在虛擬環境中安裝和更新 AWS CLI 版本 1
<a name="install-virtualenv"></a>

您可以在虛擬環境中安裝第 1 版 AWS Command Line Interface (AWS CLI)，以避免需求版本與其他`pip`套件衝突。

**Topics**
+ [先決條件](#install-virtualenv-prereqs)
+ [在虛擬環境中安裝和更新 AWS CLI 版本 1](#install-virtualenv-install)
+ [針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷](#install-virtualenv-tshoot)

## 先決條件
<a name="install-virtualenv-prereqs"></a>
+ Python 3.8 或更高版本。如需安裝說明，請參閱 Python《入門指南》**中的[下載 Python](https://wiki.python.org/moin/BeginnersGuide/Download)。

  **Python 版本支援矩陣**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/cli/v1/userguide/install-virtualenv.html)
+ `pip` 或 `pip3` 已安裝。

## 在虛擬環境中安裝和更新 AWS CLI 版本 1
<a name="install-virtualenv-install"></a>

1. 使用 `pip` 安裝 `virtualenv`。

   ```
   $ pip install --user virtualenv
   ```

1. 建立虛擬環境並為其命名。

   ```
   $ virtualenv ~/cli-ve
   ```

   或者，您可以使用 `-p` 選項以指定非預設的 Python 版本。

   ```
   $ virtualenv -p /usr/bin/python37 ~/cli-ve
   ```

1. 啟用新的虛擬環境。

   **Linux 或 macOS**

   ```
   $ source ~/cli-ve/bin/activate
   ```

   **Windows**

   ```
   $ %USERPROFILE%\cli-ve\Scripts\activate
   ```

   提示會變更，以顯示您的虛擬環境為作用中。

   ```
   (cli-ve)~$
   ```

1. 在虛擬環境中安裝或更新第 1 AWS CLI 版。

   ```
   (cli-ve)~$ pip install --upgrade awscli
   ```

1. 確認 AWS CLI 版本 1 已正確安裝。

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

1. 您可以使用 `deactivate` 命令來離開虛擬環境。每當您啟動新的工作階段時，您都必須重新啟用環境。

## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷
<a name="install-virtualenv-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 --version`」命令會傳回版本 AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1)。