Apple M2设备无法导入pyodbc问题求助

一、彻底清理残留文件 #

• 卸载pyodbc：pip uninstall -y pyodbc
• 强制卸载brew安装的unixODBC：brew uninstall --force unixodbc
• 手动删除残留：
  • 删除Python站点包内的pyodbc相关文件：rm -rf /Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/site-packages/pyodbc*
  • 删除unixODBC的系统级残留：rm -rf /usr/local/lib/libodbc* /usr/local/include/odbc*

二、适配Apple Silicon架构安装unixODBC #

• 强制以arm64架构安装unixODBC：arch -arm64 brew install unixodbc
• 验证安装结果，执行odbcinst -j，确认输出的ODBC Drivers和ODBC Data Sources路径指向/usr/local/Cellar/unixodbc/下的arm64版本文件

三、绑定unixODBC库编译安装pyodbc #

• 设置环境变量，指定unixODBC的头文件和库路径：

  export LDFLAGS="-L/usr/local/opt/unixodbc/lib"
  export CPPFLAGS="-I/usr/local/opt/unixodbc/include"
  

• 编译安装pyodbc：pip install --no-binary :all: pyodbc

四、验证Python环境架构匹配 #

• 检查当前Python解释器的架构：python3 -c "import platform; print(platform.machine())"，确保输出为arm64
• 在VS Code中，通过左下角的Python解释器选择器，确认选中的是arm64版本的Python 3.11，避免使用Rosetta模拟的x86_64版本

五、排查权限与系统限制 #

• 检查pyodbc编译后的库文件权限：ls -l /Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/site-packages/pyodbc.cpython-311-darwin.so，确保当前用户拥有读取权限（权限至少为r--r--r--）
• 若上述步骤无效，可临时关闭系统完整性保护（SIP）测试：
  1. 重启Mac，按住Command+R进入恢复模式
  2. 打开终端，执行csrutil disable后重启
  3. 测试pyodbc导入，问题解决后记得重新开启SIP：重复步骤1，执行csrutil enable

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