如何解决Jupyter Notebook安装库时的Wheel配置问题（含MariaDB报错案例）

出现这个问题的核心原因是：mariadb 1.0.11这类旧版本没有预编译的Wheel包，必须从源码编译安装，但编译需要依赖系统层面的MariaDB开发库，同时旧版pip/setuptools也可能不兼容它的安装脚本。

下面是具体解决步骤：

1. 先装系统级依赖库 #

根据你的操作系统执行对应命令：

• Ubuntu/Debian：
  sudo apt-get install libmariadb-dev
• CentOS/RHEL：
  sudo yum install mariadb-devel
• macOS（已安装Homebrew的前提下）：
  brew install mariadb-connector-c

2. 升级pip、setuptools和wheel #

旧工具版本可能拖后腿，先升级：
pip install --upgrade pip setuptools wheel

3. 重新安装mariadb==1.0.11 #

在Jupyter Notebook里直接执行：
!pip install mariadb==1.0.11

4. 编译路径问题的补救（针对部分环境） #

如果还是失败，可能是系统找不到MariaDB的头文件和库文件，手动指定路径试试（以macOS为例，Linux路径需自行调整）：
!pip install mariadb==1.0.11 --global-option=build_ext --global-option="-I/usr/local/include/mariadb" --global-option="-L/usr/local/lib"

5. 备选方案：换用新版本mariadb #

如果旧版本死活装不上，换个带预编译Wheel的新版本，比如：
!pip install mariadb>=1.1.0
新版本基本不需要源码编译，安装成功率高很多。

内容的提问来源于stack exchange，提问作者Kuldeep Singh Arya