已用PyInstaller --onefolder打包的文件夹，能否供无模块用户运行PyInstaller？

未安装依赖的用户能否运行？ #

完全可以。PyInstaller的--onefolder模式会把Python解释器、所有依赖的第三方模块、你的应用代码，甚至运行所需的系统动态库都打包到输出文件夹里。用户不需要提前安装Python或任何依赖，直接运行文件夹里的主可执行文件（Windows下是.exe，Mac下是.app或二进制文件，Linux下是可执行程序）就能启动应用。

为什么--add-data没成功？ #

大概率是语法用错了，不同操作系统的路径分隔符不一样：

• Windows下用分号;分隔源路径和目标路径
• Mac/Linux下用冒号:分隔

另外还要注意两点：

• 源路径是相对于你执行PyInstaller命令的当前目录，要确保路径准确
• 目标路径是打包后文件在输出文件夹里的位置，比如想把assets文件夹原封不动放到打包根目录，就写"assets;assets"（Windows）或"assets:assets"（Linux/Mac）

正确打包步骤示例 #

假设你的项目结构是：

my_app/
├── main.py
└── assets/
    ├── image.png
    └── config.ini

Windows环境 #

执行命令：

pyinstaller --onefolder --add-data "assets;assets" main.py

打包后，dist/main/文件夹里会有main.exe和assets子文件夹，用户运行main.exe就能正常读取assets里的文件。

Mac/Linux环境 #

执行命令：

pyinstaller --onefolder --add-data "assets:assets" main.py

打包后，dist/main/文件夹里会有main可执行文件和assets子文件夹，用户直接运行./main即可。

额外注意事项 #

• 如果代码里有动态加载文件的逻辑，要借助sys._MEIPASS获取打包后的临时运行路径（PyInstaller会把部分文件解压到临时目录），示例代码：

  import sys
  import os
  
  def get_resource_path(relative_path):
      try:
          base_path = sys._MEIPASS
      except Exception:
          base_path = os.path.abspath(".")
      return os.path.join(base_path, relative_path)
  
  # 读取配置文件
  config_path = get_resource_path("assets/config.ini")
  

  这样不管是开发环境还是打包后，都能正确找到文件。
• 如果打包后提示缺失文件，用--debug=imports参数重新运行PyInstaller，查看导入日志，确认哪些模块或文件没被打包进去。

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