使用pyinstaller打包pygame项目报Unable to access file错误怎么办

报错原因及解决步骤 #

Unable to access file报错通常由资源路径适配问题、文件占用/权限问题、依赖打包不全导致，可按以下步骤逐一排查：

• 修复资源路径逻辑：Pygame项目涉及的图片、音频等外部资源，在开发环境用相对路径可正常读取，但打包为单文件exe后，运行时exe会先解压到系统临时目录，相对路径的根目录会变更为临时目录，无法定位原资源文件。可在代码中加入如下路径适配逻辑：

import sys
import os

def get_resource_path(relative_path):
    # 适配打包后运行环境与开发环境的路径差异
    if getattr(sys, 'frozen', False):
        base_path = sys._MEIPASS
    else:
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# 后续所有资源加载都调用该方法，示例：
# bg_image = pygame.image.load(get_resource_path("images/bg.png")).convert()
# bgm = pygame.mixer.music.load(get_resource_path("audio/bgm.mp3"))

• 打包时绑定资源文件：执行打包命令时加入--add-data参数把所有资源目录一起打包，假设你的资源都放在项目根目录的assets文件夹下，Windows环境打包命令为：
  pyinstaller --onefile --add-data "assets/*;assets/" version2.py
  Mac/Linux环境打包命令为：
  pyinstaller --onefile --add-data "assets/*:assets/" version2.py
• 排查文件占用与权限问题：打包前关闭所有正在占用version2.py的程序（包括打开文件的编辑器、正在运行脚本的终端窗口），使用管理员权限启动终端后再执行打包命令，避免系统权限限制导致pyinstaller无法读取源文件。
• 排查依赖缺失问题：如果上述操作完成后还是报错，可加入隐式导入Pygame的参数执行打包：
  pyinstaller --onefile --hidden-import pygame version2.py

如果你使用虚拟环境开发，需要确认执行打包命令的终端已激活对应虚拟环境，pyinstaller、Pygame等依赖都安装在当前激活的环境中，避免跨环境依赖缺失导致的报错。

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