Windows下VS Code中pip安装mariadb报错求助

解决步骤 #

1. 确认MariaDB Connector/C的实际安装路径 #

默认安装路径通常为：

• 64位版本：C:\Program Files\MariaDB\MariaDB Connector C 64-bit
• 32位版本：C:\Program Files (x86)\MariaDB\MariaDB Connector C
  如果不确定，可通过控制面板→程序和功能找到MariaDB Connector/C，右键选择「更改」，在安装向导中查看准确安装路径。

2. 设置环境变量指向Connector/C安装目录 #

临时设置（仅当前命令行有效）

打开命令提示符（CMD），先执行：

set MARIADB_CC_INSTALL_DIR="你的Connector/C安装路径"

示例（64位版本）：

set MARIADB_CC_INSTALL_DIR="C:\Program Files\MariaDB\MariaDB Connector C 64-bit"

接着运行pip安装命令：

pip install mariadb

永久设置（全局生效）

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
2. 在「系统变量」区域点击「新建」，输入：
   • 变量名：MARIADB_CC_INSTALL_DIR
   • 变量值：你的Connector/C安装路径（如C:\Program Files\MariaDB\MariaDB Connector C 64-bit）
3. 保存设置后重启VS Code或命令行，重新执行pip install mariadb

3. 直接安装预编译wheel包（跳过编译步骤） #

如果上述方法无效，可直接下载对应Python版本和系统的预编译wheel包，规避编译依赖问题：

1. 运行python --version确认Python版本，同时确认系统位数
2. 找到匹配的.whl文件（如Python 3.10 + Windows 64位对应mariadb-1.1.10-cp310-cp310-win_amd64.whl）
3. 执行安装命令：

pip install 文件名.whl

4. 检查位数匹配情况 #

确保Python的位数与MariaDB Connector/C的位数一致：

• 运行以下代码查看Python位数：

import sys
print(sys.maxsize > 2**32)  # 返回True为64位，False为32位

如果不匹配，卸载当前Connector/C，安装对应位数的版本后重试。

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