一、C/C++ 编译器缺失（如安装xgboost提示 “Microsoft Visual C++ 14.0 is required”）
- 解决办法：
- Windows：安装Visual C++ Build Tools 2019（勾选 “C++ 构建工具”）
- Linux：安装 gcc/g++：sudo apt-get install gcc g++（Ubuntu）或yum install gcc-c++（CentOS）
- macOS：安装 Xcode 命令行工具：xcode-select –install。
二、系统库缺失（如libssl.so.1.1: cannot open shared object file）
- 解决办法：
- Linux：安装对应系统库：sudo apt-get install libssl-dev（Ubuntu）或yum install openssl-devel（CentOS）
- 查找缺失库的包名：用apt-file search libssl.so.1.1（Ubuntu）定位所属安装包
- 手动下载库文件放到/usr/lib或/usr/local/lib，执行ldconfig刷新缓存。
三、编译内存不足（如g++: internal compiler error: Killed (program cc1plus)）
- 解决办法：
- 增加虚拟内存（Linux：sudo dd if=/dev/zero of=/swapfile bs=1G count=4 → 启用 swap）
- 限制并行编译数量：pip install xgboost –install-option=”–jobs=2″（指定 2 个进程）
- 升级服务器内存（针对长期开发环境）。
四、macOS 签名验证失败（如ERROR: Failed to install package due to invalid or corrupted package）
- 解决办法：
- 临时关闭签名验证：sudo spctl –master-disable（安装后可重新启用：sudo spctl –master-enable）
- 用conda安装预编译版本：conda install -c conda-forge 库名
- 更新 macOS 系统到最新版本，修复系统证书问题。
五、预编译二进制文件不兼容（如 ARM 架构安装 x86 版本库）
- 解决办法：
- 确认系统架构（uname -m查看，如aarch64为 ARM）
- 安装针对 ARM 的版本：pip install 库名 –platform manylinux2014_aarch64
- 从源码编译安装：git clone 库源码地址 && cd 库目录 && python setup.py install。