本文详解在 PyInstaller 打包过程中正确引入本地开发包（如 CompanyAPI）的关键方法，涵盖环境变量配置、路径处理、安装方式选择及常见错误规避，确保 import CompanyAPI 在生成的 .exe 中正常工作。
本文详解在 pyinstaller 打包过程中正确引入本地开发包（如 companyapi）的关键方法，涵盖环境变量配置、路径处理、安装方式选择及常见错误规避，确保 import companyapi 在生成的 .exe 中正常工作。
在使用 PyInstaller 将含本地包（如 CompanyAPI）的 Python 项目打包为可执行文件时，常见错误 ModuleNotFoundError: No module named 'CompanyAPI' 并非源于导入语法本身，而是 PyInstaller 在构建阶段无法自动发现未安装或未显式声明的本地包。根本原因在于：PyInstaller 默认仅扫描已安装到 Python 环境中的第三方包和脚本直接引用的模块，而本地开发包若未以“可导入方式”注册到 Python 解释器路径中，即使 sys.path.append() 在运行时生效，也无法被 PyInstaller 的静态分析识别。
✅ 推荐方案：以可编辑模式安装本地包（最可靠）
进入项目根目录（即含 setup.py 的 CompanyAPI/ 目录），在目标打包所用的 Python 环境中（强烈建议使用虚拟环境，避免污染系统环境）执行：
pip install -e .
⚠️ 注意：
-e表示 editable install（开发模式），.指当前目录。该命令会将CompanyAPI注册为一个“已安装包”，其__init__.py和子模块均可被标准 import 机制解析，并被 PyInstaller 自动识别——无需--hidden-import，也无需手动修改sys.path。
验证是否成功安装：
立即学习“Python免费学习笔记（深入）”；
python -c "import CompanyAPI; print(CompanyAPI.__file__)"
应输出类似 .../src/CompanyAPI/CompanyAPI/__init__.py 的路径（editable 安装通常指向源码位置）。
随后使用 PyInstaller 打包主程序（如 main.py）：
pyinstaller --onefile main.py
此时 from CompanyAPI import site1 将在 .exe 中无缝运行。
❌ 不推荐的替代方案及风险
-
设置
PYTHONPATH：虽然临时添加export PYTHONPATH=/path/to/CompanyAPI:$PYTHONPATH可能使import在开发时生效，但 PyInstaller 默认忽略PYTHONPATH，且该方式缺乏可移植性，不适用于分发。 -
硬编码
sys.path.extend(...)：虽能在运行时补救导入，但需在main.py开头显式添加路径，且必须确保路径在打包后仍有效（例如使用sys._MEIPASS动态定位资源），易出错且违背封装原则。 -
仅用
--hidden-import CompanyAPI：此参数仅用于告知 PyInstaller “该模块会被动态导入”，但无法解决模块本身未被发现的问题；若包未安装，PyInstaller 仍找不到其源码，打包会失败或运行时报错。
? 补充说明：PyCharm 中的包识别
若希望在 PyCharm 中获得完整代码提示与导航，右键点击 CompanyAPI/CompanyAPI/ 目录 → Mark Directory as → Sources Root 即可。这仅影响 IDE 解析，与 PyInstaller 打包无关。真正决定打包成败的是 Python 解释器能否在 site-packages 或 sys.path 中定位到该包——而这正由 pip install -e . 保证。
✅ 最终检查清单
- [ ]
setup.py正确声明了name="CompanyAPI"和packages=find_packages()； - [ ] 在打包所用虚拟环境中执行
pip install -e .； - [ ] 运行
pyinstaller main.py时不加--hidden-import（除非有明确的动态导入场景）； - [ ] 打包后测试生成的
.exe是否能成功import CompanyAPI并调用site1功能。
遵循以上流程，即可稳定、可复现地将本地开发包集成进 PyInstaller 可执行文件，兼顾开发体验与生产部署可靠性。
