安装MySQL Connector/Python报错：Python版本未找到（Python3.11.0）求助

排查及解决步骤 #

1. 安装适配Python 3.11的Connector版本 #

MySQL Connector/Python 8.0.29及以上版本才支持Python 3.11，直接指定兼容版本安装：

pip install mysql-connector-python==8.3.0

（8.3.0为适配3.11的稳定版本，也可选择更高的兼容版本）

2. 确保pip与Python 3.11对应 #

若系统存在多版本Python，需明确调用Python 3.11的pip：

• Linux/macOS：

  python3.11 -m pip install mysql-connector-python
  

• Windows：

  py -3.11 -m pip install mysql-connector-python
  

3. 检查Python 3.11的环境变量配置 #

• Windows：右键「此电脑」→属性→高级系统设置→环境变量，在系统变量Path中确认包含Python 3.11的安装路径（如C:\Users\你的用户名\AppData\Local\Programs\Python\Python311）和Scripts路径（C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts），缺失则添加后重启命令行。
• Linux/macOS：终端执行echo $PATH，确认Python3.11的bin目录在路径内，若不在则修改shell配置文件（如~/.bashrc或~/.zshrc）：

  export PATH="/usr/local/python3.11/bin:$PATH"
  

  执行source ~/.bashrc（对应你的shell配置文件）生效。

4. 手动下载whl包安装 #

若pip安装仍失败，下载对应Python3.11的whl安装包，本地安装：

pip install 本地whl文件的完整路径

5. 验证安装结果 #

打开Python交互环境，执行以下代码：

import mysql.connector
print(mysql.connector.__version__)

能正常打印版本号则说明安装成功。

内容的提问来源于stack exchange，提问作者MrVishavOP