PyInstaller 在打包时可能无法自动识别 akshare 库的依赖，导致未将其打包

PyInstaller 在打包时可能无法自动识别 akshare 库的依赖，导致未将其打包

解决方法

以下是解决方法：

1. 检查 PyInstaller 的 Hook 文件：
   PyInstaller 使用 hook 文件来处理第三方库的动态依赖。akshare 可能需要自定义 hook 文件。

   • 在 PyInstaller 的安装目录下（通常是 site-packages/PyInstaller/hooks），检查是否有 hook-akshare.py。

   • 如果没有，创建一个简单的 hook-akshare.py，内容如下：

     from PyInstaller.utils.hooks import collect_data_files
     
     datas = collect_data_files('akshare')
     

   • 将此文件放入 hooks 目录，或在打包时使用 --add-hook-dir 指定自定义 hook 路径。

2. 手动添加 akshare 依赖：
   使用 --add-data 或 --add-binary 参数手动包含 akshare 的文件。

   • 找到 akshare 的安装路径（通常在 site-packages/akshare）。
   • 运行 PyInstaller 时添加：

     pyinstaller --add-data "path/to/site-packages/akshare;akshare" your_script.py
     

     注意分隔符：Windows 用 ;，Linux/Mac 用 :。

3. 使用 --hidden-import：
   如果 akshare 的某些模块未被正确识别，尝试显式导入：

   pyinstaller --hidden-import akshare your_script.py
   

   如果有特定子模块未被打包（如 akshare.data），也需要单独添加。

4. 检查动态加载的依赖：
   akshare 可能动态加载数据文件或依赖其他库（如 pandas, requests）。运行打包后的程序，查看错误日志，确认缺少的具体文件或模块，然后用 --add-data 或 --hidden-import 添加。

5. 使用虚拟环境：
   在干净的虚拟环境中安装仅必要的依赖（包括 akshare），避免无关库干扰 PyInstaller 的依赖分析。

6. 调试打包过程：

   • 运行 pyinstaller --log-level DEBUG your_script.py 查看详细日志，确认哪些文件被忽略。
   • 检查生成的 build/your_script/warn-your_script.txt 文件，查找 akshare 相关的警告。

示例命令：

pyinstaller --add-data "path/to/site-packages/akshare;akshare" --hidden-import akshare --clean your_script.py

验证：
打包完成后，运行生成的可执行文件，确认 akshare 功能正常。如果仍失败，检查错误信息，可能是 akshare 依赖的外部资源（如网络数据）未正确处理。

--clean 参数的作用

在 PyInstaller 中，--clean 参数的作用是清除之前打包过程中生成的缓存文件和临时文件，确保从头开始一个干净的打包过程。具体效果包括：

1. 删除缓存目录：

   • 清除 build 和 dist 目录中的旧文件（但不会删除 dist 目录中的最终输出文件，除非再次打包覆盖）。
   • 删除 PyInstaller 的内部缓存（如 .pyc 文件或其他临时文件）。

2. 避免旧依赖干扰：

   • 有时，之前的打包可能遗留错误的依赖或配置，使用 --clean 可以避免这些旧数据影响新打包。

3. 解决奇怪的打包问题：

   • 如果遇到莫名其妙的错误（如缺失文件或依赖冲突），--clean 可以帮助重置环境，排除缓存导致的问题。

使用场景：

• 当修改了代码或依赖后，重新打包时建议加上 --clean。
• 调试 PyInstaller 打包问题时，确保结果可重复。

示例：

pyinstaller --clean --add-binary "path/to/libmini_racer.dylib:." your_script.py

注意：

• --clean 不会影响你的源代码或 Python 环境，仅清理 PyInstaller 的工作目录。
• 打包时间可能略微增加，因为需要重新分析依赖。

报错：py_mini_racer._dll.LibNotFoundError: Native library or dependency not available at /path/to/project/_internal/libmini_racer.dylib

错误 py_mini_racer.\_dll.LibNotFoundError: Native library or dependency not available at /path/to/project/_internal/libmini_racer.dylib 表明 PyInstaller 打包后，py_mini_racer 依赖的动态库 libmini_racer.dylib 未正确包含或无法加载。这通常是 akshare 间接依赖 py_mini_racer（用于 JavaScript 执行）导致的问题。以下是解决方法：

1. 确认问题来源

py_mini_racer 是一个需要本地动态库支持的模块，PyInstaller 默认可能无法正确识别或打包其 .dylib 文件（macOS 动态链接库）。需要手动确保 libmini_racer.dylib 被包含。

2. 手动添加 libmini_racer.dylib

• 定位动态库：
  找到 py_mini_racer 的安装目录。通常在 Python 的 site-packages 路径下：

  python -c "import py_mini_racer; print(py_mini_racer.__file__)"
  

  然后在 site-packages/py_mini_racer 或相关目录下查找 libmini_racer.dylib。

• 添加到 PyInstaller：
  使用 --add-binary 参数将动态库打包：

  pyinstaller --add-binary "path/to/py_mini_racer/libmini_racer.dylib:." your_script.py
  

  设置目标文件夹为根目录

  要将文件放入根目录，设置 dest_path 为 .：

  pyinstaller --add-binary "/path/to/py_mini_racer/libmini_racer.dylib:." your_script.py
  

3. 创建 PyInstaller Hook 文件

如果手动添加仍失败，可能是 py_mini_racer 的依赖未被正确解析。创建一个自定义 hook 文件：

• 在项目目录或 PyInstaller 的 hooks 目录（site-packages/PyInstaller/hooks）中创建 hook-py_mini_racer.py：

  from PyInstaller.utils.hooks import collect_data_files, collect_dynamic_libs
  
  datas = collect_data_files('py_mini_racer')
  binaries = collect_dynamic_libs('py_mini_racer')
  

• 运行 PyInstaller 时，确保 hook 被识别：

  pyinstaller --additional-hooks-dir . your_script.py
  

  （假设 hook-py_mini_racer.py 在当前目录）。

4. 检查 macOS 动态库依赖

libmini_racer.dylib 可能依赖其他系统库（如 libstdc++ 或 libc++）。用 otool 检查：

otool -L /path/to/py_mini_racer/libmini_racer.dylib

如果有未找到的依赖，需确保这些库在目标 macOS 系统上可用，或用 --add-binary 打包相关系统库。

5. 升级或降级 py_mini_racer

py_mini_racer 的某些版本可能与 PyInstaller 或 macOS 兼容性有问题。尝试：

• 升级：

  pip install --upgrade py_mini_racer
  

• 或降级到稳定版本：

  pip install py_mini_racer==0.6.0
  

  然后重新打包：

  pyinstaller --clean your_script.py
  

6. 绕过 py_mini_racer（可选）

如果 akshare 仅在特定功能（如获取实时数据）使用 py_mini_racer，检查你的代码是否可以避免调用这些功能。例如，切换到 akshare 的其他数据接口（不依赖 JavaScript 执行）。查看 akshare 文档，确认是否有替代方法。

7. 调试和验证

• 清空缓存：打包前删除 build 和 dist 目录，确保无残留文件：

  rm -rf build dist
  

• 详细日志：运行 PyInstaller 时添加 --log-level DEBUG：

  pyinstaller --log-level DEBUG --add-binary "path/to/py_mini_racer/libmini_racer.dylib:." your_script.py
  

  检查日志中是否提到 py_mini_racer 或 libmini_racer.dylib 的处理。
• 测试打包结果：运行生成的可执行文件，确认是否还有其他缺失依赖。

示例命令

假设 libmini_racer.dylib 位于 path/to/py_mini_racer/，完整命令可能为：

pyinstaller --add-binary "path/to/py_mini_racer/libmini_racer.dylib:." --add-data "path/to/akshare:akshare" --hidden-import akshare --clean your_script.py