macOS下Conda环境导入LightGBM报错：libomp.dylib缺失求助

错误信息 #

OSError: dlopen(/Users/hp/opt/anaconda3/envs/MachineLearning/lib/python3.9/site-packages/lightgbm/lib/lib_lightgbm.so, 0x0006): Library not loaded: /usr/local/opt/libomp/lib/libomp.dylib
Referenced from: <3AF1EF0C-311C-31EC-BCE3-679F37ABEE16> /Users/hp/opt/anaconda3/envs/MachineLearning/lib/python3.9/site-packages/lightgbm/lib/lib_lightgbm.so
Reason: tried: '/usr/local/opt/libomp/lib/libomp.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OS/usr/local/opt/libomp/lib/libomp.dylib' (no such file), '/usr/local/opt/libomp/lib/libomp.dylib' (no such file), '/usr/local/lib/libomp.dylib' (no such file), '/usr/lib/libomp.dylib' (no such file, not in dyld cache)

环境信息 #

• Python版本：3.9
• Conda环境：MachineLearning
• 操作系统：macOS

问题概述 #

在macOS的MachineLearning Conda环境中导入LightGBM时触发上述OSError，已尝试设置LDFLAGS和CPPFLAGS环境变量但无效，需解决此问题以推进Streamlit和FastAPI项目开发。

错误原因分析 #

• LightGBM依赖OpenMP（libomp）并行计算库，但当前系统中找不到指定路径的libomp.dylib文件
• pip安装的LightGBM预编译包默认指向Homebrew安装的libomp路径，但系统要么未安装Homebrew版libomp，要么安装路径不匹配
• 手动设置环境变量未生效，可能是设置时机不对（未在安装LightGBM前设置）或环境变量未正确作用于Conda环境

解决步骤 #

方法1：通过Conda直接安装LightGBM（推荐） #

Conda维护的LightGBM包会自动处理依赖，适配macOS环境：

1. 激活目标Conda环境：

   conda activate MachineLearning
   

2. 卸载已安装的pip版LightGBM：

   pip uninstall -y lightgbm
   

3. 通过Conda安装LightGBM：

   conda install -c conda-forge lightgbm
   

4. 测试导入：

   import lightgbm
   

方法2：通过Homebrew安装libomp并修复路径 #

若坚持使用pip版LightGBM，需确保系统有匹配路径的libomp：

1. 安装Homebrew（未安装时执行）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装libomp：

   brew install libomp
   

3. 创建软链接匹配LightGBM期望的路径：

   sudo mkdir -p /usr/local/opt/libomp/lib
   sudo ln -s /usr/local/Cellar/libomp/*/lib/libomp.dylib /usr/local/opt/libomp/lib/libomp.dylib
   

4. 重新激活环境并测试：

   conda activate MachineLearning
   python -c "import lightgbm"
   

方法3：从源码编译LightGBM（适配Conda环境） #

上述方法无效时，手动编译适配当前环境：

1. 卸载现有LightGBM：

   pip uninstall -y lightgbm
   

2. 安装编译依赖：

   conda activate MachineLearning
   conda install -c conda-forge cmake openmp
   

3. 克隆LightGBM源码：

   git clone --recursive https://github.com/microsoft/LightGBM
   cd LightGBM/python-package
   

4. 编译并安装：

   python setup.py install --precompile
   

5. 测试导入：

   import lightgbm
   

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