PyInstaller打包Tkinter应用遇ModuleNotFoundError求助

问题根源 #

你用sys.path.append(os.path.join(os.getcwd(), "moduleName"))添加路径的方式，在onefile模式打包后会彻底失效——因为onefile exe运行时会把所有资源解压到系统临时目录（比如C:\Users\<用户名>\AppData\Local\Temp\_MEIxxxxxx），此时os.getcwd()指向的是你双击exe的目录，而非临时解压目录，自然找不到模块。另外，手动加--path和--hidden-import可能因为依赖关系没覆盖全、路径配置不精准，所以没解决问题。

具体解决方案 #

1. 修正模块导入逻辑（核心步骤） #

放弃sys.path.append的野路子，改用标准的包导入方式：

• 确保所有文件夹（Folder1、Folder2等）的__init__.py文件存在（你已经满足这一点）
• 在main.py里用绝对导入调用Folder1的模块：

  from Folder1 import module1, module2
  

• 在Folder1的模块（比如module1.py）里，同样用绝对导入调用其他文件夹的模块：

  from Folder2 import module3
  from Folder3 import module4
  

  这种标准写法能让PyInstaller自动分析依赖链，不需要手动凑路径。

2. 用Spec文件代替命令行参数打包 #

命令行参数太局限，生成spec文件后手动配置更可靠：

1. 生成初始spec文件：

   pyinstaller --windowed --noconsole --onefile main.py
   

   执行后会得到main.spec文件。
2. 编辑main.spec：
   • 在Analysis段的pathex里添加项目根目录（main.py所在目录）的绝对路径，比如：

     pathex=['C:\\your-project-root-path'],
     

   • 如果有PyInstaller没自动检测到的模块，在hiddenimports里补全，比如：

     hiddenimports=['Folder2.module3', 'Folder3.module4'],
     

3. 用spec文件重新打包：

   pyinstaller main.spec
   

3. 排查路径问题的调试技巧 #

如果还是报错，先临时去掉--noconsole参数打包，运行exe时查看控制台输出：

• 在代码里加调试代码，打印运行时的sys.path：

  import sys
  print("当前sys.path:", sys.path)
  

  看输出里有没有临时解压目录，以及模块所在文件夹是否在路径列表中。

4. 额外注意点 #

• 不要用os.getcwd()获取模块路径，改用os.path.dirname(os.path.abspath(__file__))获取当前脚本的绝对路径，比如：

  import os
  current_script_dir = os.path.dirname(os.path.abspath(__file__))
  sys.path.append(os.path.join(current_script_dir, "Folder2"))
  

  这种写法在打包后的临时环境里也能正常工作。
• 用pyinstaller --list-imports main.py查看PyInstaller检测到的导入列表，确认所有依赖模块都在其中。

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