Ubuntu 系統預設 pip 指向 Python 2.7，直接 pip install 會裝到 Python 2 環境。正確做法是建立 Python 3 虛擬環境，使用 pip3 安裝。本文提供標準化 SOP。
python3 --version # 確認 3.x apt-get update && apt-get install -y python3-venv # 或 python3-virtualenv
# 建議專案目錄下建立 python3 -m venv venv_mysql # 標準庫 venv (Python 3.3+) # 或 virtualenv -p /usr/bin/python3 venv_mysql # virtualenv 方式 # 啟用 source venv_mysql/bin/activate # 提示符變為 (venv_mysql) $
pip install --upgrade pip pip install mysql-connector-python
驗證：
python -c "import mysql.connector; print(mysql.connector.__version__)"
| 現象 | 原因 | 解決 |
|---|---|---|
pip: command not found | 未安裝 pip | apt-get install python3-pip 或 python3 -m ensurepip --upgrade |
mysql-connector-python 安裝極慢 | PyPI 國內訪問慢 | pip install -i https://pypi.tuna.tsinghua.edu.cn/simple mysql-connector-python |
| 系統 Python 3 版本過舊（如 3.4） | 驅動要求 3.5+ | 編譯安裝新版 Python 3.8+，或改用 PyMySQL（支援 3.4+） |
venv_mysql 打包進 Docker 鏡像，或使用 pip freeze > requirements.txt 固定版本。source venv_mysql/bin/activate 再啟動服務。sudo pip3 install），汙染系統環境且難以版本管理。結語：虛擬環境是 Python 專案依賴隔離的標準做法。掌握 python3 -m venv + pip3 流程，即可乾淨安裝任意 Python 3 套件，包含 mysql-connector-python。
