如何将带Assets文件夹的Pygame Python游戏打包为可分发独立应用

一、用PyInstaller打包（适配Assets资源文件夹） #

PyInstaller是最适合这类场景的打包工具，下面分两种常用方式：

1. 保留Assets文件夹结构（适合资源体积大、需要后续修改资源的情况） #

• 先确保代码里的资源路径是相对路径，绝对路径会导致打包后找不到资源：

  import os
  # 基于当前脚本文件的位置定位Assets文件夹
  ASSETS_PATH = os.path.join(os.path.dirname(__file__), 'Assets')
  
  # 读取示例：图片/音频都用这个路径拼接
  player_img = pygame.image.load(os.path.join(ASSETS_PATH, 'player.png'))
  jump_sound = pygame.mixer.Sound(os.path.join(ASSETS_PATH, 'jump.wav'))
  

• 安装PyInstaller：pip install pyinstaller
• 执行打包命令（假设主源码文件是main.py）：

  # Windows系统用分号分隔路径
  pyinstaller main.py --add-data "Assets;Assets"
  # Linux/macOS系统用冒号分隔路径
  pyinstaller main.py --add-data "Assets:Assets"
  

• 打包完成后，把dist文件夹里的可执行文件（Windows是.exe，Linux/macOS是无后缀文件）和整个Assets文件夹放在同一目录，别人就能直接运行。

2. 把Assets打包进单文件（无需额外携带文件夹） #

这种方式会把资源打包进可执行文件，运行时自动解压到临时目录，需要稍微修改代码适配路径：

• 修改资源读取逻辑：

  import os
  import sys
  
  def get_assets_path():
      # 判断是否是打包后的运行环境
      if getattr(sys, 'frozen', False):
          # 打包后PyInstaller会把资源放在临时目录sys._MEIPASS下
          return os.path.join(sys._MEIPASS, 'Assets')
      else:
          # 开发环境下的相对路径
          return os.path.join(os.path.dirname(__file__), 'Assets')
  
  ASSETS_PATH = get_assets_path()
  # 后续读取资源的代码和之前一致即可
  

• 执行单文件打包命令：

  # Windows
  pyinstaller main.py --onefile --add-data "Assets;Assets"
  # Linux/macOS
  pyinstaller main.py --onefile --add-data "Assets:Assets"
  

• 打包完成后，dist文件夹里的单个可执行文件就是独立的，双击就能运行，不需要带Assets文件夹。

二、跨操作系统运行说明 #

• PyInstaller打包的程序是平台专属的：Windows上打包出的.exe只能在Windows跑，macOS上打包出的.app/可执行文件只能在macOS跑，Linux同理。
• 如果要做跨平台版本，必须分别在对应系统上打包：比如要出Windows版，就在Windows电脑上装Python、Pygame、PyInstaller后执行打包命令；macOS和Linux版本以此类推。
• 进阶跨平台方案：可以用PyOxidizer或Nuitka工具尝试一次打包多平台，但配置复杂度较高，适合有一定经验的开发者。

三、常见问题排查 #

• 打包后找不到资源：检查代码里有没有用绝对路径（比如C:\xxx\Assets），必须改成相对路径或适配打包后的路径逻辑。
• 音频/图片加载失败：确保--add-data参数里的文件夹名和实际完全一致，Linux/macOS区分大小写。
• Windows下运行弹出黑框：如果是纯GUI游戏，打包时加--windowed参数隐藏控制台：

  pyinstaller main.py --onefile --windowed --add-data "Assets;Assets"
  

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