**本文件 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
本主題提供 AWS Command Line Interface (AWS CLI) 的安裝、更新和解除安裝。AWS CLI 第 1 版目前受支援，但 AWS CLI 第 2 版的新增功能可能並未新增至 AWS CLI 第 1 版。若要使用這些功能，您必須安裝 AWS CLI 第 2 版。如需安裝第 2 版的相關資訊，請參閱 [安裝 AWS CLI 第 2 版](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)。
**Topics**
+ [Python 版本要求](#cli-chap-install-python)
+ [Amazon Linux](install-linux-al2017.md)
+ [Linux](install-linux.md)
+ [macOS](install-macos.md)
+ [Windows](install-windows.md)
+ [Virtualenv](install-virtualenv.md)
## Python 版本要求
AWS CLI 第 1 版是使用適用於 Python 的開發套件所建置的，因此需要您安裝相容的 Python 版本。
**Python 版本支援對照表**
| AWS CLI 版本 | 支援的 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 及更舊版本 |
如需 AWS CLI 最新版本的詳細資訊，請參閱 GitHub 上的 [AWS CLI 第 2 版變更日誌](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)。
# 在 Amazon Linux 上安裝、更新和解除安裝第 1 AWS CLI 版
第 1 AWS CLI 版預先安裝在 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 執行個體的時間而定，第 1 AWS CLI 版會使用下列其中一個套件管理員預先安裝：
+ [pip](#install-amazon-linux-pip)
+ [yum](#install-amazon-linux-yum)
## 先決條件
您必須安裝 Python 3.8 版或更新版本。如需安裝說明，請參閱 Python《入門指南》**中的[下載 Python](https://wiki.python.org/moin/BeginnersGuide/Download)。
**Python 版本支援矩陣**
| AWS CLI 版本 | 支援的 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 安裝、更新或解除安裝
大多數 Amazon Linux 執行個體使用 pip 來預先安裝第 1 AWS CLI 版。
### 使用 pip 在 Amazon Linux 上安裝或更新 AWS CLI 版本 1
若要為目前使用者安裝最新版本的 第 1 AWS CLI 版，請使用下列指示。
1. 如果您已安裝 Python 第 3 版或更新版本，建議您使用 `pip3`。使用 `pip3 install` 安裝或更新至最新版本的 第 1 AWS CLI 版。如果您在 [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
如果您需要解除安裝 AWS CLI，請使用 `pip uninstall`。
```
$ pip3 uninstall awscli
```
## 使用 yum 安裝、更新或解除安裝
大多數 Amazon Linux 2 執行個體使用 yum 來預先安裝第 1 AWS CLI 版。
### 使用 yum 在 Amazon Linux 上安裝或更新 AWS CLI 版本 1
若要安裝 Amazon Linux 上可用的最新版本 第 1 AWS CLI 版，請執行下列命令。
```
$ 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
若要解除安裝 AWS CLI，請使用 `yum remove`。
```
$ sudo yum remove awscli
```
## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷
如果您在安裝或解除安裝 之後遇到問題 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)。
# 在 Linux 上安裝、更新和解除安裝第 1 AWS CLI 版
您可以使用`pip`套件管理員或綁定安裝程式，在大多數 Linux 發行版本上安裝 AWS Command Line Interface (AWS CLI) 第 1 版及其相依性。
雖然 `awscli` 套件可在其他套件管理員的儲存庫中使用，例如 `apt`和 `yum`，但 不會產生、管理或支援這些套件 AWS。我們建議您僅 AWS CLI 從官方 AWS 分發點安裝 ，如本指南所述。
**Topics**
+ [先決條件](#install-linux-prereqs)
+ [使用綁定安裝程式在 Linux 上安裝和解除安裝第 1 AWS CLI 版](#install-linux-bundled)
+ [使用 pip 安裝和解除安裝 AWS CLI 版本 1](#install-linux-pip)
+ [使用 Snapcraft 安裝和解除安裝第 1 AWS CLI 版](#install-linux-snap)
+ [將 AWS CLI 版本 1 可執行檔新增至命令列路徑](#install-linux-path)
+ [針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷](#install-linux-tshoot)
## 先決條件
您必須安裝 Python 3.8 版或更新版本。如需安裝說明，請參閱 Python《入門指南》**中的[下載 Python](https://wiki.python.org/moin/BeginnersGuide/Download)。
**Python 版本支援矩陣**
| AWS CLI 版本 | 支援的 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 及更舊版本 |
## 使用綁定安裝程式在 Linux 上安裝和解除安裝第 1 AWS CLI 版
在 Linux 或 macOS 上，您可以使用 Bundled Installer 來安裝 AWS CLI第 1 版。Bundled Installer 包含所有的依存項目，並可於離線使用。
**注意**
Bundled Installer 無法安裝到包含空格的路徑。
**Topics**
+ [使用隨附安裝程式搭配 安裝第 1 AWS CLI 版 `sudo`](#install-linux-bundled-sudo)
+ [使用不含 的套件安裝程式安裝第 1 AWS CLI 版 `sudo`](#install-linux-bundled-no-sudo)
+ [解除安裝第 1 AWS CLI 版綁定安裝程式](#install-linux-bundled-uninstall)
### 使用隨附安裝程式搭配 安裝第 1 AWS CLI 版 `sudo`
下列步驟可讓您在任何 Linux 或 macOS 建置上，從命令列安裝 AWS CLI 版本 1。
下列是您可以剪貼當成一組命令來執行的安裝命令的摘要。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
請依照命令列中的下列步驟，使用綁定安裝程式安裝第 1 AWS CLI 版。
**使用綁定安裝程式安裝第 1 AWS CLI 版**
1. 使用下列其中一種方法下載第 1 AWS CLI 版綁定安裝程式。
+ 使用 `curl` 命令下載。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 使用直接連結下載。
**如需 AWS CLI的最新版本：**[https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下 URL：[https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)
1. 從套件中解壓縮檔案。如果您沒有 `unzip` 來擷取檔案，請使用 Linux 發行版本內建的套件管理工具來安裝它。
```
$ unzip awscli-bundle.zip
```
1. 執行安裝程式。安裝程式 AWS CLI 會在 上安裝 ，`/usr/local/aws`並在 `aws` `/usr/local/bin`目錄建立符號連結。使用 `-b` 選項來建立符號連結，可減少在使用者的 `$PATH` 變數中指定安裝目錄的需要。這應該可讓所有使用者`aws`從任何目錄輸入 AWS CLI 來呼叫 。
```
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
根據預設，安裝指令碼會在系統預設版本的 Python 下執行。如果您已安裝 Python 的替代版本，並想要使用該版本安裝 AWS CLI，請透過 Python 可執行檔的絕對路徑使用該版本執行安裝指令碼，如下所示。
```
$ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
1. 確認 已正確 AWS CLI 安裝。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md)。
### 使用不含 的套件安裝程式安裝第 1 AWS CLI 版 `sudo`
如果您沒有`sudo`許可或只想 AWS CLI 為目前使用者安裝 ，您可以使用先前命令的修改版本。前兩個命令是相同的。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**為目前使用者安裝 AWS CLI 版本 1**
1. 使用下列其中一種方式下載第 1 AWS CLI 版綁定安裝程式。
+ 使用 `curl` 命令下載。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 使用直接連結下載。
**如需 AWS CLI的最新版本：**[https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下 URL：[https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)
1. 從套件中使用 `unzip` 解壓縮檔案。如果您沒有 `unzip`，請使用 Linux 發行版本內建的套件管理工具來安裝它。
```
$ unzip awscli-bundle.zip
```
1. 執行安裝程式。安裝程式 AWS CLI 會在 上安裝 ，`/usr/local/aws`並在 `aws` `/usr/local/bin`目錄建立符號連結。最後一個命令會使用 `-b` 參數來指定安裝程式放置 `aws` 符號連結檔案的資料夾。您必須具有指定資料夾的寫入權限。
```
$ ./awscli-bundle/install -b ~/bin/aws
```
這會將 安裝 AWS CLI 到預設位置 (`~/.local/lib/aws`)，並在 建立符號連結 （符號連結）`~/bin/aws`。請確保 `~/bin` 位於您的 `PATH` 環境變數，以讓符號連結能順利執行。
```
$ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
```
1. 請確定 AWS CLI 版本 1 是`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=~/.local/bin:$PATH
```
這個命令會將此範例中的路徑 `~/.local/bin` 新增到目前現有 `PATH` 變數的前端。
1. 將描述檔重新載入到目前的工作階段，讓這些變更生效。
```
$ source ~/.bash_profile
```
1. 確認 已正確 AWS CLI 安裝。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md)。
### 解除安裝第 1 AWS CLI 版綁定安裝程式
1. 如果您 AWS CLI 使用綁定安裝程式安裝 ，請遵循下列指示。Bundled Installer 不會在安裝目錄之外的位置存放資料 (選用符號連結除外)，所以解除安裝十分簡單，就是直接刪除這兩個項目。
```
$ sudo rm -rf /usr/local/aws
$ sudo rm -rf /usr/local/bin/aws
```
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和登入資料設定會跨 AWS SDKs和 共用 AWS CLI。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *\$1/.aws/*。如果您的使用者具有此資料夾的寫入許可，則不需要使用 `sudo`。
```
$ sudo rm -r ~/.aws/
```
## 使用 pip 安裝和解除安裝 AWS CLI 版本 1
**Topics**
+ [安裝 pip](#install-linux-pip-pip)
+ [使用 pip 安裝和更新 AWS CLI 版本 1](#install-linux-awscli)
+ [AWS CLI 使用 pip 解除安裝](#post-install-uninstall)
### 安裝 pip
如果尚未安裝 `pip`，您可以使用 *Python Packaging Authority* 提供的指令碼來安裝。執行 `pip --version` 來查看您的 Linux 版本是否已包含 Python 和 `pip`。如果您已安裝 Python 第 3 版以上的版本，我們建議您使用 `pip3` 命令。
1. 使用 `curl` 命令下載安裝指令碼。以下命令使用 `-O` (大寫字母「O」) 參數，指定下載的檔案要存放在目前的資料夾中，並使用遠端主機上的相同名稱。
```
$ curl -O https://bootstrap.pypa.io/get-pip.py
```
1. 搭配 `python` 或 `python3` 命令執行指令碼來下載並安裝最新版本的 `pip` 及其他必要的支援套件。當您加入 `--user` 參數，指令碼會將 `pip` 安裝到路徑 `~/.local/bin`。
```
$ python3 get-pip.py --user
```
1. 請確保包含 `pip` 的目錄是 `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=~/.local/bin:$PATH
```
這個命令會將此範例中的路徑 `~/.local/bin` 新增到目前現有 `PATH` 變數的前端。
1. 將描述檔重新載入到目前的工作階段，讓這些變更生效。
```
$ source ~/.bash_profile
```
1. 若要確認 `pip` 或 `pip3` 已正確安裝，請執行下列命令。
```
$ pip3 --version
pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)
```
### 使用 pip 安裝和更新 AWS CLI 版本 1
1. 使用 `pip` 或 `pip3` 命令來安裝或更新 AWS CLI。如果您使用 Python 第 3 版，建議您使用 `pip3` 命令。`--user` 交換器會將 `pip` 安裝 AWS CLI 到 `~/.local/bin`。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ pip3 install awscli --upgrade --user
```
**對於特定版本的 AWS CLI，** 會將兩個相等的符號`=`和版本編號附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 *==1.16.312*，因此使用以下命令：
```
$ pip3 install awscli==1.16.312 --upgrade --user
```
**注意**
使用終端機適當的引用規則。為了使用 `=` 字元，您可能需要使用單引號或雙引號才能正確逸出。以下範例使用單引號進行轉義：
```
$ pip3 install 'awscli==1.16.312' --upgrade --user
```
1. 確認 已正確 AWS CLI 安裝。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md)。
### AWS CLI 使用 pip 解除安裝
1. 如果您使用 安裝 AWS CLI 版本 1`pip`，您也必須使用 解除安裝 `pip`。
```
$ pip uninstall awscli
```
如果您使用的是 Python 2 或 3 版，則可能需要使用 `pip2` 或 `pip3` 命令。使用 `aws --version`命令來判斷與您已安裝第 1 版相關聯的 Python AWS CLI 版本。
```
$ pip3 uninstall awscli
```
您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和登入資料設定會跨 AWS SDKs和 共用 AWS CLI。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *\$1/.aws/*。如果您的使用者具有此資料夾的寫入許可，則不需要使用 `sudo`。
```
$ sudo rm -r ~/.aws/
```
## 使用 Snapcraft 安裝和解除安裝第 1 AWS CLI 版
**Topics**
+ [安裝 snap](#install-linux-snap-install)
+ [使用 snap 安裝和更新 AWS CLI 版本 1](#install-linux-snap-update)
+ [AWS CLI 使用 snap 解除安裝](#install-linux-snap-uninstall)
### 安裝 snap
如果您尚未安裝 `snap`，您可以使用 *Canonical Snapcraft* 提供的指示進行安裝。執行 `snap version` 來查看您的 Linux 版本是否已包含 `snap`。
1. 在平台上安裝 Snapcraft。如需安裝 Snapcraft 的詳細資訊，請參閱 *Snap 文件*中的[安裝常駐程式](https://snapcraft.io/docs/installing-snapd)。
1. 重新啟動系統，以正確更新 `PATH` 變數。如果您有安裝問題，請遵循 *Snap 文件*中[修正常見問題](https://snapcraft.io/docs/fix-common-issues)的步驟。
1. 若要確認 `snap` 已正確安裝，請執行下列命令。
```
$ snap version
```
### 使用 snap 安裝和更新 AWS CLI 版本 1
1. 針對第 1 AWS CLI 版執行下列`snap install`命令。
```
$ snap install aws-cli --channel=v1/stable --classic
```
根據您的許可，您可能需要將 `sudo` 新增至命令。
```
$ sudo snap install aws-cli --channel=v1/stable --classic
```
1. 確認 已正確 AWS CLI 安裝。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md)。
### AWS CLI 使用 snap 解除安裝
1. 如果您使用 安裝 AWS CLI 版本 1`snap`，您也必須使用 解除安裝 `snap`。
```
$ snap remove aws-cli
```
您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和登入資料設定會跨 AWS SDKs和 共用 AWS CLI。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *\$1/.aws/*。如果您具有此目錄的寫入許可，則不需要使用 `sudo`。
```
$ sudo rm -r ~/.aws/
```
## 將 AWS CLI 版本 1 可執行檔新增至命令列路徑
在使用 `pip` 或 `snap` 進行安裝後，您可能需要將 `aws` 可執行檔新增到作業系統的 `PATH` 環境變數中。
您可以執行下列命令來驗證在 AWS CLI 中`pip`安裝的資料夾。
```
$ which aws
/home/username/.local/bin/aws
```
您可以將此參考為 `~/.local/bin/`，因為在 Linux 中 `/home/username` 對應至 `~`。
如果您忽略 `--user` 參數並因此沒有以使用者模式進行安裝，可執行檔可能位於 Python 安裝的 `bin` 資料夾中。如果您不知道 Python 的安裝位置，請執行此命令。
```
$ which python
/usr/local/bin/python
```
輸出可能是符號連結的路徑，而非實際可執行檔。執行 `ls -al` 來查看其指向的路徑。
```
$ ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6
```
`pip` 將程式安裝到包含 Python 應用程式的相同資料夾中。將此資料夾新增至 `PATH` 變數。
**修改 `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=~/.local/bin:$PATH
```
這個命令將路徑 (此範例中的 `~/.local/bin`) 新增到目前的 `PATH` 變數。
1. 將更新過的設定檔載入到您目前工作階段。
```
$ source ~/.bash_profile
```
## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷
如果您在安裝或解除安裝 之後遇到問題 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)。
# 在 macOS 上安裝、更新和解除安裝第 1 AWS CLI 版
您可以使用綁定安裝程式或 ，在 macOS 上安裝 AWS Command Line Interface (AWS CLI) 第 1 版及其相依性`pip`。
**Topics**
+ [先決條件](#install-macosos-prereq)
+ [使用綁定安裝程式在 macOS 上安裝、更新和解除安裝第 1 AWS CLI 版](#install-macosos-bundled)
+ [使用 pip 安裝、更新和解除安裝第 1 AWS CLI 版](#awscli-install-osx-pip)
+ [針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷](#awscli-install-osx-tshoot)
## 先決條件
在 macOS 上安裝第 1 AWS CLI 版之前，請確定您已安裝 Python 3.8 或更新版本。如需安裝說明，請參閱 Python《入門指南》**中的[下載 Python](https://wiki.python.org/moin/BeginnersGuide/Download)。
**Python 版本支援矩陣**
| AWS CLI 版本 | 支援的 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 及更舊版本 |
## 使用綁定安裝程式在 macOS 上安裝、更新和解除安裝第 1 AWS CLI 版
在 Linux 或 macOS 上，您可以使用 Bundled Installer 來安裝 AWS Command Line Interface (AWS CLI) 第 1 版。Bundled Installer 包含所有的依存項目，並可於離線使用。
Bundled Installer 無法安裝到包含空格的路徑。
**Topics**
+ [使用隨附安裝程式搭配 安裝第 1 AWS CLI 版 `sudo`](#install-macosos-bundled-sudo)
+ [使用不含 的套件安裝程式安裝第 1 AWS CLI 版 `sudo`](#install-macosos-bundled-no-sudo)
+ [解除安裝第 1 AWS CLI 版綁定安裝程式](#install-macosos-bundled-uninstall)
### 使用隨附安裝程式搭配 安裝第 1 AWS CLI 版 `sudo`
下列步驟可讓您在任何 macOS 建置上，從命令列安裝 AWS CLI 版本 1。
以下是您可以剪貼當成一組命令來執行的安裝命令的摘要。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**使用綁定安裝程式安裝第 1 AWS CLI 版**
1. 使用下列其中一種方式下載第 1 AWS CLI 版綁定安裝程式：
+ 使用 `curl` 命令下載。
**若為最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**若為特定版本的 AWS CLI**，請在檔案名稱中附加連字號和版本號碼。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 使用直接連結下載。
**如需 AWS CLI的最新版本：**[https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下 URL：[https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)
1. 解壓縮 (解壓縮) 套件中的檔案。如果您沒有 `unzip`，請使用 macOs 發行版本內建的套件管理工具來安裝它。
```
$ unzip awscli-bundle.zip
```
1. 執行安裝程式。安裝程式 AWS CLI 會在 上安裝 ，`/usr/local/aws`並在 `aws` `/usr/local/bin` 資料夾建立符號連結。使用 `-b` 選項來建立符號連結，可減少在使用者的 `$PATH` 變數中指定安裝資料夾的需要。這應該可讓所有使用者`aws`從任何目錄輸入 AWS CLI 來呼叫 。
```
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
根據預設，安裝指令碼會在系統預設版本的 Python 下執行。如果您已安裝 Python 的替代版本，並想要使用該版本來安裝 AWS CLI，請透過 Python 可執行檔的絕對路徑使用該版本執行安裝指令碼，如下所示。
```
$ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
1. 確認 已正確 AWS CLI 安裝。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md)。
### 使用不含 的套件安裝程式安裝第 1 AWS CLI 版 `sudo`
如果您沒有`sudo`許可或只想 AWS CLI 為目前使用者安裝 ，您可以使用先前命令的修改版本。前兩個命令是相同的。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**為目前使用者安裝 AWS CLI 版本 1**
1. 使用下列其中一種方法下載第 1 AWS CLI 版綁定安裝程式：
+ 使用 `curl` 命令下載。
**若為最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**若為特定版本的 AWS CLI**，請在檔案名稱中附加連字號和版本號碼。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 使用直接連結下載。
**如需 AWS CLI的最新版本：**[https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**對於特定版本的 AWS CLI，**請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 `awscli-bundle-1.16.312.zip`，因此使用以下 URL：[https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)
1. 從套件中解壓縮檔案。如果您沒有 `unzip`，請使用 Linux 發行版本內建的套件管理工具來安裝它。
```
$ unzip awscli-bundle.zip
```
1. 執行安裝程式。安裝程式 AWS CLI 會在 上安裝 ，`/usr/local/aws`並在 `aws` `/usr/local/bin`目錄建立符號連結。最後一個命令會使用 `-b` 參數來指定安裝程式放置 `aws` 符號連結檔案的資料夾。您必須具有指定目錄的寫入許可。
```
$ ./awscli-bundle/install -b ~/bin/aws
```
這會將 安裝 AWS CLI 到預設位置 (`~/.local/lib/aws`)，並在 建立符號連結 （符號連結）`~/bin/aws`。請確保 `~/bin` 位於您的 `$PATH` 環境變數，以讓符號連結能順利執行。
```
$ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
```
1. 請確定版本 AWS CLI 1 已安裝在 中的資料夾是 `$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=~/.local/bin:$PATH
```
這個命令會將此範例中的路徑 `~/.local/bin` 新增到目前現有 `PATH` 變數的前端。
1. 將描述檔重新載入到目前的工作階段，讓這些變更生效。
```
$ source ~/.bash_profile
```
1. 確認 已正確 AWS CLI 安裝。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md)。
### 解除安裝第 1 AWS CLI 版綁定安裝程式
1. 由於 Bundled Installer 會將除了可選符號連結之外的所有內容放在安裝目錄中，因此若要解除安裝，您只需刪除這兩個項目即可。
```
$ sudo rm -rf /usr/local/aws
$ sudo rm /usr/local/bin/aws
```
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI之間共用。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *\$1/.aws/*。如果您的使用者具有此資料夾的寫入許可，則不需要使用 `sudo`。
```
$ sudo rm ~/.aws/
```
## 使用 pip 安裝、更新和解除安裝第 1 AWS CLI 版
您也可以直接使用 `pip` 安裝 AWS CLI。
**Topics**
+ [安裝 pip](#awscli-install-osx-pip-pip)
+ [AWS CLI 使用 pip 安裝和更新](#awscli-install-osx-pip-install)
+ [將第 1 AWS CLI 版可執行檔新增至您的 macOS 命令列路徑](#awscli-install-osx-path)
+ [AWS CLI 使用 pip 解除安裝](#awscli-install-osx-pip-uninstall)
### 安裝 pip
如果尚未安裝 `pip`，您可以使用 *Python Packaging Authority* 提供的指令碼來安裝。執行 `pip --version` 來查看您的 Linux 版本是否已包含 Python 和 `pip`。如果您已安裝 Python 第 3 版以上的版本，我們建議您使用 `pip3` 命令。
1. 使用 `curl` 命令下載安裝指令碼。以下命令使用 `-O` (大寫字母「O」) 參數，指定下載的檔案要存放在目前的資料夾中，並使用遠端主機上的相同名稱。
```
$ curl -O https://bootstrap.pypa.io/get-pip.py
```
1. 搭配 `python` 或 `python3` 命令執行指令碼來下載並安裝最新版本的 `pip` 及其他必要的支援套件。當您加入 `--user` 參數，指令碼會將 `pip` 安裝到路徑 `~/.local/bin`。
```
$ python3 get-pip.py --user
```
### AWS CLI 使用 pip 安裝和更新
1. 使用 `pip` 或 `pip3` 命令來安裝 AWS CLI。如果您使用 Python 第 3 版或更新版本，我們建議您使用 `pip3` 命令。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
$ pip3 install awscli --upgrade --user
```
**對於特定版本的 AWS CLI，** 會將兩個相等的符號`=`和版本編號附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 *==1.16.312*，因此使用以下命令：
```
$ pip3 install awscli==1.16.312 --upgrade --user
```
**注意**
使用終端機適當的引用規則。若要使用 `=` 字元，您可能需要使用單引號或雙引號才能正確逸出。以下範例使用單引號進行轉義：
```
$ pip3 install 'awscli==1.16.312' --upgrade --user
```
1. 確認 AWS CLI 已正確安裝。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6
```
如果找不到此程式，請[將它新增到命令列路徑](#awscli-install-osx-path)。
### 將第 1 AWS CLI 版可執行檔新增至您的 macOS 命令列路徑
在使用 `pip` 進行安裝後，您可能需要將 `aws` 程式新增到作業系統的 `PATH` 環境變數中。程式的位置取決於 Python 的安裝位置。
**Example AWS CLI 安裝位置 - 使用 Python 3.6 和 `pip`（使用者模式） 的 macOS**
```
~/Library/Python/3.7/bin
```
請以您的 Python 版本替代上述範例中的版本。
如果您不知道 Python 的安裝位置，請執行 `which python`。
```
$ which python
/usr/local/bin/python
```
輸出可能是符號連結的路徑，而非實際的程式。執行 `ls -al` 來查看其指向的路徑。
```
$ ls -al /usr/local/bin/python
~/Library/Python/3.7/bin/python3.7
```
`pip` 將程式安裝到包含 Python 應用程式的相同資料夾中。將此資料夾新增至 `PATH` 變數。
**修改 `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=~/.local/bin:$PATH
```
這個命令將路徑 (此範例中的 `~/.local/bin`) 新增到目前的 `PATH` 變數。
1. 將更新過的設定檔載入到您目前工作階段。
```
$ source ~/.bash_profile
```
### AWS CLI 使用 pip 解除安裝
1. 如果您使用 安裝 AWS CLI 版本 1`pip`，您也必須使用 解除安裝 `pip`。
```
$ pip uninstall awscli
```
如果您使用的是 Python 2 或 3 版，則可能需要使用 `pip2` 或 `pip3` 命令。使用 `aws --version`命令來判斷與您已安裝第 1 版相關聯的 Python AWS CLI 版本。
```
$ pip3 uninstall awscli
```
您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI之間共用。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *\$1/.aws/*。如果您的使用者具有此資料夾的寫入許可，則不需要使用 `sudo`。
```
$ sudo rm -rf ~/.aws/
```
## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷
如果您在安裝或解除安裝 之後遇到問題 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)。
# 在 Windows 上安裝、更新和解除安裝第 1 AWS CLI 版
您可以使用獨立的安裝程式 （建議AWS CLI) 或 (Python 套件管理員）`pip`，在 Windows 上安裝 AWS Command Line Interface () 版本 1。
輸入命令時，請不要包含提示符號 (`C:\>`)。這些內容包括在程式清單中，用於區分您從 AWS CLI傳回的輸出中輸入的命令。本指南的其餘部分會使用通用提示符號 (`$`)，除非使用的是 Windows 專用命令。
**Topics**
+ [使用 MSI 安裝程式安裝、更新和解除安裝第 1 AWS CLI 版](#msi-on-windows)
+ [在 Windows 上使用 Python 和 pip 安裝、更新和解除安裝 AWS CLI 版本 1](#awscli-install-windows-pip)
+ [將 AWS CLI 版本 1 可執行檔新增至命令列路徑](#awscli-install-windows-path)
+ [針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷](#awscli-install-windows-tshoot)
## 使用 MSI 安裝程式安裝、更新和解除安裝第 1 AWS CLI 版
Windows XP 或更新版本支援 第 1 AWS CLI 版。對於 Windows 使用者，MSI 安裝套件提供熟悉且方便的方式安裝第 1 AWS CLI 版，而無需安裝任何其他先決條件。
### 使用 MSI 安裝程式安裝和更新 AWS CLI 版本 1
請查看 [GitHub 上的 Releases 頁面](https://github.com/aws/aws-cli/releases)，以了解最新版本何時發佈。當發佈更新時，您必須重複安裝過程以獲取 AWS CLI 第 1 版的最新版本。
1. 下載合適的 MSI 安裝程式：
+ AWS CLI 適用於 Windows 的 MSI 安裝程式 (64 位元）：https：//[https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi)
+ AWS CLI 適用於 Windows 的 MSI 安裝程式 (32 位元）：https：//[https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi)
+ AWS CLI Windows 的合併設定檔案：[https：//https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe](https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe) （包含 32 位元和 64 位元 MSI 安裝程式，並自動安裝正確的版本）
1. 執行下載的 MSI 安裝程式或設定檔案。
1. 遵循螢幕說明。根據預設，第 1 AWS CLI 版會安裝到 `C:\Program Files\Amazon\AWSCLI`(64 位元版本） 或 `C:\Program Files (x86)\Amazon\AWSCLI`(32 位元版本）。
1. 若要確認安裝，請在命令提示字元使用 `aws --version` 命令 (您可以開啟**開始**功能表，並搜尋 `cmd` 來啟動命令提示字元)。
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或手動[將安裝目錄新增到 PATH](#awscli-install-windows-path) 環境變數。
### 解除安裝第 1 AWS CLI 版
若要使用下列解除安裝說明，您必須搭配 MSI 安裝程式或設定檔案來安裝 AWS CLI 第 1 版。
1. 請執行下列其中一個動作來開啟**程式和功能**：
+ 開啟**控制台**，然後選擇**程式和功能**。
+ 開啟命令提示字元並執行下列命令。
```
C:\> appwiz.cpl
```
1. 選擇名為 **AWS Command Line Interface** 的項目，然後選擇**解除安裝**以啟動解除安裝程式。
1. 確認您要解除安裝 AWS CLI。
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI之間共用。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *%UserProfile%\$1.aws*。
```
$ rmdir %UserProfile%\.aws
```
## 在 Windows 上使用 Python 和 pip 安裝、更新和解除安裝 AWS CLI 版本 1
Python 軟體基金會為 Windows 提供包含 `pip` 的安裝程式。
### 先決條件
您必須安裝 Python 3.8 版或更新版本。如需安裝說明，請參閱 Python《入門指南》**中的[下載 Python](https://wiki.python.org/moin/BeginnersGuide/Download)。
### 使用 pip 安裝和更新 AWS CLI 版本 1
1. 若要安裝第 1 AWS CLI 版，請使用 `pip3`命令 （如果您使用 Python 第 3 版或更新版本） 或 `pip`命令。
**對於最新版本的 AWS CLI，**請使用下列命令區塊：
```
C:\> pip3 install awscli --upgrade --user
```
**對於特定版本的 AWS CLI，**請將小於 符號`<`和版本編號附加至檔案名稱。在這個範例中，版本 *1.16.312* 的檔案名稱為 *<1.16.312*，因此使用以下命令：
```
C:\> pip3 install awscli<1.16.312 --upgrade --user
```
1. 確認 AWS CLI 版本 1 已正確安裝。如果沒有回應，請參閱 [將 AWS CLI 版本 1 可執行檔新增至命令列路徑](#awscli-install-windows-path) 一節。
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
### 使用 pip 解除安裝 AWS CLI 版本 1
1. 如果您使用 安裝 AWS CLI 版本 1`pip`，您也必須使用 解除安裝 `pip`。
```
C:\> pip uninstall awscli
```
如果您使用的是 Python 2 或 3 版，則可能需要使用 `pip2` 或 `pip3` 命令。使用 `aws --version`命令來判斷與您已安裝第 1 版相關聯的 Python AWS CLI 版本。
```
C:\> pip3 uninstall awscli
```
您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI之間共用。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *%UserProfile%\$1.aws*。
```
$ rmdir %UserProfile%\.aws
```
## 將 AWS CLI 版本 1 可執行檔新增至命令列路徑
使用 安裝 AWS CLI 版本 1 之後`pip`，請將`aws`程式新增至作業系統`PATH`的環境變數。使用 MSI 安裝時，這應該會自動發生。但是，如果在安裝之後沒有執行 `aws` 命令，您可能需要手動設定它。
1. 使用 `where` 命令尋找 `aws` 檔案位置。依預設，`where` 命令會顯示在系統的 `PATH` 中找到指定程式的位置。
```
C:\> where aws
```
顯示的路徑取決於您的平台以及您用來安裝 AWS CLI的方法。包括版本號碼的資料夾名稱可能有所不同。上述範例會反映使用 Python 3.7 版的情形。視需要將版本替換為您正在使用的版本號碼。典型路徑包括下列各項：
+ **Python 3 和 `pip3`** – `C:\Program Files\Python37\Scripts\`
+ **Python 3 和 `pip3` – 舊版 Windows 上的使用者選項** – `%USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts`
+ **Python 3 和 `pip3` – Windows 10 上的使用者選項** – `%USERPROFILE%\AppData\Roaming\Python\Python37\Scripts`
+ **MSI 安裝程式 (64 位元)** – `C:\Program Files\Amazon\AWSCLI\bin`
+ **MSI 安裝程式 (32 位元)** – `C:\Program Files (x86)\Amazon\AWSCLI\bin`
根據是否傳回檔案路徑使用下列步驟。
------
#### [ A file path is returned ]
```
C:\> where aws
C:\Program Files\Amazon\AWSCLI\bin\aws.exe
```
您可以執行下列命令，找到 `aws` 程式的安裝位置。
```
C:\> where c:\ aws
C:\Program Files\Python37\Scripts\aws
```
------
#### [ A file path is NOT returned ]
如果 `where` 命令傳回下列錯誤，則其不在系統 `PATH` 中，而您不能只輸入其名稱來執行。
```
C:\> where c:\ aws
INFO: Could not find files for the given pattern(s).
```
此時請以 `/R path` 參數執行 `where` 命令，要求其搜尋所有資料夾，然後手動加入路徑。使用命令列或檔案總管來探索它在您電腦上的安裝位置。
```
C:\> where /R c:\ aws
c:\Program Files\Amazon\AWSCLI\bin\aws.exe
c:\Program Files\Amazon\AWSCLI\bincompat\aws.cmd
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws.cmd
...
```
------
1. 按下 Windows 鍵並輸入 **environment variables**。
1. 選擇 **Edit environment variables for your account (編輯您帳戶的環境變數)**。
1. 選擇 **PATH**，然後選擇 **Edit (編輯)**。
1. 將您找到的路徑加入**變數值**欄位中，例如 ***C:\$1Program Files\$1Amazon\$1AWSCLI\$1bin\$1aws.exe***。
1. 選擇 **OK** (確定) 兩次以套用新的設定。
1. 關閉任何正在執行的命令提示，並重新開啟命令提示字元視窗。
## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷
如果您在安裝或解除安裝 之後遇到問題 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)。
# 在虛擬環境中安裝和更新 AWS CLI 版本 1
您可以在虛擬環境中安裝第 1 版 AWS Command Line Interface (AWS CLI)，以避免需求版本與其他`pip`套件衝突。
**Topics**
+ [先決條件](#install-virtualenv-prereqs)
+ [在虛擬環境中安裝和更新 AWS CLI 版本 1](#install-virtualenv-install)
+ [針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷](#install-virtualenv-tshoot)
## 先決條件
+ 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
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 安裝和解除安裝錯誤進行故障診斷
如果您在安裝或解除安裝 之後遇到問題 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)。