PyInstaller打包报错Hidden import 'IpregistryClient'找不到问题咨询

1. 校验Python环境一致性 #

出现该问题90%以上的原因是PyInstaller运行环境和ipregistry库安装环境不匹配：

• 如果你使用PyCharm的虚拟环境，必须先激活对应虚拟环境再执行打包操作，Windows系统激活命令为venv\Scripts\activate，macOS/Linux系统激活命令为source venv/bin/activate
• 执行pip show ipregistry查看库的安装路径，执行where pyinstaller（Windows）或which pyinstaller（macOS/Linux）查看PyInstaller的安装路径，确认两者属于同一个Python版本的目录结构。如果PyInstaller没有安装在当前环境，执行pip install pyinstaller重新安装即可。

2. 手动指定隐藏导入 #

如果环境确认一致，是PyInstaller静态依赖检测没有识别到ipregistry的导入关系，打包时添加隐藏导入参数即可：

pyinstaller --onefile --hidden-import ipregistry 你的脚本文件名.py

如果仍提示IpregistryClient相关报错，可补充指定类的导入路径：

pyinstaller --onefile --hidden-import ipregistry --hidden-import ipregistry.IpregistryClient 你的脚本文件名.py

3. 用spec文件配置依赖（针对复杂依赖场景） #

如果上述方法仍不生效，可通过spec文件固定依赖配置：

1. 先执行命令生成spec配置文件：pyi-makespec 你的脚本文件名.py
2. 打开生成的.spec后缀文件，找到hiddenimports配置项，修改为：

   hiddenimports=['ipregistry', 'ipregistry.IpregistryClient']
   

3. 基于spec文件执行打包：pyinstaller 你的脚本文件名.spec

4. 手动指定库搜索路径 #

如果ipregistry安装在非标准路径，打包时可添加paths参数指定库的安装目录，路径来自之前pip show ipregistry输出的Location值：

pyinstaller --onefile --hidden-import ipregistry --paths "你的ipregistry安装路径" 你的脚本文件名.py

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