如何解决Anaconda环境中的SQLite3导入错误

错误原因 #

Anaconda环境中预编译的_sqlite3模块依赖_sqlite3_enable_load_extension符号，但macOS系统自带的/usr/lib/libsqlite3.dylib默认禁用了SQLite扩展加载功能，导致该符号不存在，触发导入错误。

解决方案 #

方案1：让Anaconda使用Homebrew的SQLite（推荐） #

Homebrew安装的SQLite默认启用扩展支持，只需让Python优先加载该库：

• 临时生效（当前终端会话）：

  conda activate smol-cls-clustering
  export DYLD_LIBRARY_PATH="/opt/homebrew/opt/sqlite/lib:$DYLD_LIBRARY_PATH"
  

• 永久生效（写入环境配置）：
  编辑环境的激活脚本，确保每次激活环境时自动设置变量：

  echo 'export DYLD_LIBRARY_PATH="/opt/homebrew/opt/sqlite/lib:$DYLD_LIBRARY_PATH"' >> /opt/homebrew/anaconda3/envs/smol-cls-clustering/etc/conda/activate.d/env_vars.sh
  

  执行完后重新激活环境：

  conda deactivate && conda activate smol-cls-clustering
  

方案2：重新编译_sqlite3模块 #

如果方案1无效，可手动编译适配Homebrew SQLite的_sqlite3模块：

1. 安装编译依赖：

   brew install sqlite autoconf automake libtool
   

2. 从Python 3.11官方源码包中提取Modules/_sqlite3目录，进入该目录后执行编译安装：

   conda activate smol-cls-clustering
   python setup.py build_ext --include-dirs=/opt/homebrew/opt/sqlite/include --library-dirs=/opt/homebrew/opt/sqlite/lib --rpath=/opt/homebrew/opt/sqlite/lib install
   

方案3：创建新环境并绑定Homebrew SQLite #

若现有环境配置混乱，可直接创建新环境：

conda create -n new-smol-cls-clustering python=3.11
conda activate new-smol-cls-clustering
export DYLD_LIBRARY_PATH="/opt/homebrew/opt/sqlite/lib:$DYLD_LIBRARY_PATH"
# 重新安装项目依赖包

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