PyInstaller打包后运行报“ModuleNotFoundError”根本原因是静态分析无法识别动态导入、隐式依赖及运行时子模块，需通过--hidden-import显式声明、--add-data补充资源或自定义hook解决。
直接双击 dist 目录下的 your_script.exe 就能测试，但多数失败不是因为打包错，而是路径、资源或环境没对齐
PyCharm 本身不提供“运行 exe”的专用功能，它只负责生成 exe；测试阶段完全脱离 IDE，靠的是 Windows 文件系统行为。很多用户卡在“双击没反应”“一闪而过”“报错找不到模块”，其实问题不在 pyinstaller，而在启动上下文和资源定位。
pyinstaller -F -w 打包后双击黑窗闪退？先看控制台输出
GUI 程序加了 -w 参数会隐藏控制台，导致错误被吞掉——根本看不到报错内容。临时绕过它才能定位问题：
- 不要双击 exe，而是用命令行运行：
dist\your_script.exe - 或者右键 exe → “复制路径”，在 PyCharm Terminal 里粘贴执行（确保当前目录是项目根目录）
- 如果看到类似
ModuleNotFoundError: No module named 'xxx'，说明某个 import 在打包时没被自动识别，需手动加--hidden-import xxx - 如果看到
FileNotFoundError: [Errno 2] No such file or directory: 'config.json'，说明你代码里用了相对路径读文件，但 exe 运行时工作目录是用户双击的位置，不是dist目录
资源文件（图片、JSON、数据库路径）为什么打包后找不到？
PyInstaller 不会自动包含你代码里 open('data.csv') 这种硬编码路径的文件。它只打包 Python 源码和已知依赖，其他都得显式声明：
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 用
--add-data "data.csv;."（Windows）或--add-data "data.csv:."（macOS/Linux），注意分号/冒号区别 - 代码里不能写
open('data.csv')，要改成动态路径：import sys, osbase_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))config_path = os.path.join(base_path, 'data.csv') - 图标、字体、配置文件全适用这套逻辑——只要不是 .py 文件，就得手动加
--add-data并改代码读取方式
PyCharm Terminal 里运行 pyinstaller 却提示 ModuleNotFoundError: No module named 'PyInstaller'？
这说明当前终端激活的 Python 解释器不是你装了 pyinstaller 的那个环境。常见于：
- 项目用了虚拟环境，但 Terminal 默认走系统 Python（或另一个 venv）
- PyCharm 设置了 conda 解释器，而
pyinstaller装在 pip 环境里 - 你在 Terminal 里手动切过
conda activate或source venv/bin/activate，但没生效或切错了
验证方法：在 Terminal 里执行 which python 和 pip list | grep pyinstaller，两者必须指向同一路径。否则就先 pip install pyinstaller 到当前解释器对应位置，别依赖“看起来装过了”。
真正麻烦的从来不是打包命令敲对没，而是 exe 启动那一刻的工作目录、模块搜索路径、资源加载路径三者是否对齐——这三个路径在开发时和打包后天然不同，不显式处理，90% 的“打包成功但运行失败”都栽在这儿。
