Install PIP (Python) on MacOS

erik · November 12, 2024, 5:45am

在 macOS 上安裝 PIP（Python 的套件管理工具）有多種方法。以下是幾種常見的安裝方式：

方法一：使用 ensurepip 模組

Python 3.4 及以上版本內建了 ensurepip 模組，可直接用於安裝 PIP：

打開「終端機」（Terminal）。
輸入以下命令並按下 Enter：
```
python3 -m ensurepip --upgrade
```
此命令將安裝或升級 PIP。

方法二：使用 Homebrew

Homebrew 是 macOS 上流行的套件管理工具，可用於安裝各種軟體，包括 Python 和 PIP：

如果尚未安裝 Homebrew，請在「終端機」中輸入以下命令並按下 Enter：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝完成後，輸入以下命令安裝 Python（同時會安裝 PIP）：
```
brew install python
```
安裝完成後，PIP 將隨 Python 一同安裝。

方法三：使用 get-pip.py 腳本

如果上述方法無法使用，您可以手動下載並執行 get-pip.py 腳本來安裝 PIP：

在「終端機」中輸入以下命令下載腳本：

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

下載完成後，執行以下命令安裝 PIP：
```
python3 get-pip.py
```
此方法將下載並安裝最新版本的 PIP。

驗證 PIP 安裝

安裝完成後，您可以通過以下命令確認 PIP 是否安裝成功：

pip3 --version

如果顯示 PIP 的版本號，則表示安裝成功。

更新 PIP

為確保您使用的是最新版本的 PIP，建議定期更新。可使用以下命令進行更新：

python3 -m pip install --upgrade pip

此命令將升級 PIP 至最新版本。

透過上述方法，您即可在 macOS 上成功安裝並管理 PIP。

erik · November 12, 2024, 5:50am

雖然 Python 已經安裝在您的 macOS 上，但當您嘗試執行 pip 命令時，系統顯示「zsh: command not found: pip」的錯誤訊息。這可能表示 PIP 尚未安裝或 PIP 的路徑沒有正確配置到您的環境變數中。

解決方法：

確認 PIP 是否安裝：
輸入以下命令來檢查 PIP 是否已隨 Python 安裝：
```
python3 -m pip --version
```
如果顯示版本號，則 PIP 已安裝，您需要確認 pip 命令是否在 PATH 環境變數中。
安裝 PIP：
如果 python3 -m pip --version 沒有返回結果，則表示需要安裝 PIP：
```
python3 -m ensurepip --upgrade
```
更新 PATH 環境變數：
如果 PIP 已安裝但無法使用 pip 命令，您需要將 Python 的 bin 目錄添加到 PATH：
- 打開 ~/.zshrc 文件：
```
nano ~/.zshrc
```
- 添加以下行：
```
export PATH="/usr/local/opt/python/libexec/bin:$PATH"
```
- 保存並退出後，執行以下命令以重新加載配置：
```
source ~/.zshrc
```
確認 PIP 命令：
再次嘗試以下命令以確認 PIP 是否可用：
```
pip3 --version
```

完成這些步驟後，您應該能夠在終端機中正常使用 PIP。

erik · November 12, 2024, 5:56am

[notice] A new release of pip is available: 24.2 -> 24.3.1
[notice] To update, run: python3.13 -m pip install --upgrade pip
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try brew install
    xyz, where xyz is the package you are trying to
    install.

這個錯誤訊息顯示環境受到 Homebrew 的管理，為了保護系統的完整性，限制了安裝 PIP 的一些操作。您可以考慮以下幾種解決方法：

方法 1：使用 `--user` 安裝

這是最安全且推薦的方法，將套件安裝到使用者的本地資料夾中，而不是全域安裝：

python3 -m pip install --upgrade pip --user

方法 2：使用虛擬環境

建立虛擬環境來隔離安裝，這樣可以避免影響系統的全域設定：

建立虛擬環境：
```
python3 -m venv myenv
```
啟用虛擬環境：
```
source myenv/bin/activate
```
安裝 PIP 或其他套件：
```
pip install --upgrade pip
```

方法 3：使用 `--break-system-packages` 選項

如果您需要在全域環境中強制安裝，可以使用以下選項（不推薦，可能會影響 Homebrew 的環境）：

python3 -m pip install --upgrade pip --break-system-packages

方法 4：使用 `pipx` 安裝

pipx 是一個工具，可幫助您將 Python 應用程式隔離安裝和執行：

安裝 pipx：
```
brew install pipx
```
使用 pipx 安裝套件：
```
pipx install <package-name>
```

注意事項

如非必要，請避免使用 --break-system-packages，因為這樣可能導致 Homebrew 安裝的 Python 出現問題。使用 --user 或虛擬環境是較為穩定和安全的做法。