解决 Numba/llvmlite 在 Mac M4 上的 libz.1.dylib 加载问题

在 Mac M4 设备上使用 Python 3.12.8 运行 Numba 和 llvmlite 时，开发者可能会遇到一个常见的动态库加载问题。这个问题表现为系统无法找到 libz.1.dylib 文件，导致 llvmlite 无法正常初始化。

问题现象

当尝试导入 pandas_ta 或其他依赖 Numba 的库时，系统会抛出以下错误：

OSError: dlopen(.../libllvmlite.dylib, 0x0006): Library not loaded: @rpath/libz.1.dylib
Reason: tried: '/usr/local/lib//libz.1.dylib' (no such file)

这个错误表明系统在 /usr/local/lib/ 目录下找不到 libz.1.dylib 文件。值得注意的是，在最新的 macOS 系统中，libz 库已经被整合到系统的 dyld 共享缓存中，而不是以独立的文件形式存在。

问题根源

经过分析，这个问题通常由以下两种情况引起：

1. 用户设置了 DYLD_FALLBACK_LIBRARY_PATH 环境变量，强制系统在非标准路径中查找动态库
2. 系统默认的库搜索路径被修改，导致无法正确找到系统内置的 libz 实现

解决方案

方法一：检查环境变量

首先检查您的 shell 配置文件（如 .zshrc 或 .bashrc）中是否设置了 DYLD_FALLBACK_LIBRARY_PATH 环境变量。如果有类似以下设置：

DYLD_FALLBACK_LIBRARY_PATH="/usr/local/lib/"
export DYLD_FALLBACK_LIBRARY_PATH

请注释或删除这些行，然后重新启动终端会话。这个环境变量会覆盖系统默认的库搜索路径，导致问题发生。

方法二：验证系统库路径

在终端中执行以下命令，确认系统是否能找到 libz：

ls -l /usr/lib/libz*

在最新的 macOS 中，您可能会看到类似 libz.1.2.12.dylib 的文件，但没有 libz.1.dylib。这是因为系统使用了更现代的版本。

方法三：重建虚拟环境

如果问题仍然存在，可以尝试以下步骤：

1. 删除现有的虚拟环境
2. 创建新的虚拟环境
3. 重新安装所有依赖项

deactivate
rm -rf .venv
python -m venv .venv
source .venv/bin/activate
pip install numba pandas_ta

与 TA-Lib 的兼容性

许多金融量化开发者同时使用 Numba 和 TA-Lib。需要注意的是，手动设置 DYLD_FALLBACK_LIBRARY_PATH 通常是尝试解决 TA-Lib 安装问题的常见做法，但这会干扰 Numba 的正常运行。

正确的做法是：

1. 从源码编译安装 TA-Lib
2. 确保安装必要的构建工具（autoconf, automake, libtool）
3. 不要修改系统级的库搜索路径

总结

在 Mac M4 设备上，Numba 和 llvmlite 依赖系统提供的 libz 库。由于 macOS 的特殊设计，这些库通常存在于 dyld 共享缓存中，而不是传统的文件路径。通过保持环境变量设置的清洁，并遵循正确的库安装方法，可以避免这类动态库加载问题。

对于同时使用 TA-Lib 的开发者，建议从源码编译安装，而不是通过修改系统库路径这种可能产生副作用的方式解决问题。这样可以确保 Numba 和 TA-Lib 都能在同一个 Python 环境中和谐共存。