macOS Python3.9下XGBoost可导入但无法加载XGBRegressor报错

问题表现 #

• 安装xgboost后直接执行import xgboost无报错，但导入XGBRegressor时提示：

cannot import name 'XGBRegressor' from 'xgboost' (unknown location).

• 打印xgboost.__file__返回值为None，使用Python版本为3.9，确认site-packages目录下存在xgboost包文件。

修复步骤 #

• 全量卸载所有环境中的xgboost包，避免多版本冲突。终端中重复执行以下卸载命令，直到提示未找到对应安装包为止：

pip uninstall xgboost -y
pip3 uninstall xgboost -y
# 若使用conda环境，额外执行
conda remove xgboost -y

• 手动清理残留文件：遍历所有Python环境对应的site-packages目录，删除所有名称包含xgboost的文件夹、.dist-info后缀文件，常见排查路径包括：
  • /Library/Python/3.9/site-packages/
  • ~/Library/Python/3.9/lib/python/site-packages/
  • 自建虚拟环境（venv/conda）对应的site-packages目录
• 验证清理结果：打开Python 3.9解释器，执行import xgboost，若抛出ModuleNotFoundError则说明残留清理完成；如果仍能导入且xgboost.__file__返回None，继续排查剩余Python路径下的残留文件删除即可。
• 重新安装xgboost，必须指定当前使用的Python解释器调用pip安装，避免包装到错误环境：
  若使用系统全局Python 3.9，执行：

  python3.9 -m pip install xgboost
  

  若使用虚拟环境，先激活对应环境后执行：

  python -m pip install xgboost
  

• 安装完成后验证：重启Python解释器，先执行print(xgboost.__file__)，正常会返回对应site-packages下的xgboost包路径，不再返回None；再执行from xgboost import XGBRegressor即可正常导入。

额外排查点 #

如果以上步骤操作完仍有问题，检查你当前运行Python脚本的工作目录下，是否存在命名为xgboost.py的文件、或命名为xgboost的文件夹，这类同名文件会被Python优先加载，覆盖官方包导致导入错误，直接重命名这类本地文件即可。

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