Pygame Windows环境加载特定MP3文件报Unable to open file错误

问题根因 #

同一段音频加载代码Mac正常、Windows报错，由三个跨平台兼容问题共同导致，按优先级修复即可： #

1. 相对路径解析规则跨平台不一致 #

代码里写的裸相对路径（audio/audio_jump.mp3、../pixel runner/audio/audio_jump.mp3），解析基准是程序启动时的工作目录，不是当前player.py文件所在目录。
Mac端启动时工作目录刚好匹配路径层级所以能正常加载，Windows端VS Code默认启动工作目录可能和项目目录不一致，直接导致找不到文件。同时Windows和Mac的路径分隔符不同（Windows用\、Mac用/），手写斜杠的路径在Windows上本身就有兼容问题。

修复方法

永远基于当前代码文件的绝对路径拼接资源路径，不写裸相对路径，修改player.py代码：

import pygame
import os

class Test(pygame.sprite.Sprite):
    def __init__(self,pos,screen):
        super().__init__()
        
        # 获取当前player.py文件所在目录的绝对路径
        current_file_dir = os.path.dirname(os.path.abspath(__file__))
        # 按实际文件层级拼接音频路径，os模块自动适配不同系统的路径分隔符、自动处理带空格的路径
        # 示例：如果audio文件夹和player.py在同级目录，就按下面写；如果在上一级就加".."层级
        jump_sound_path = os.path.join(current_file_dir, "audio", "audio_jump.mp3")

        # universial pos & screen
        self.pos = pos
        self.screen = screen
        
        # setup player
        self.image = pygame.Surface((50,100))
        self.image.fill("red")
        self.rect = self.image.get_rect(topleft = pos)
        
        # setup variables
        self.gravity = 0
        self.jump_sound = pygame.mixer.Sound(jump_sound_path)

    # 下方原有apply_gravity、jump、update方法保持不变即可

2. 未正确初始化mixer模块 #

未调用pygame.init()时，Mac端音频接口会被自动兼容唤醒，但Windows端mixer模块必须显式初始化才能加载音频文件，否则会直接抛出媒体加载错误。

修复方法

在项目主入口文件（即你直接运行的启动py文件，不是精灵类的单独文件）最开头，统一初始化pygame，优先初始化音频模块避免参数不兼容：

import pygame
# 预初始化mixer，参数适配Windows默认音频驱动，减少加载失败概率
pygame.mixer.pre_init(frequency=44100, size=-16, channels=2, buffer=512)
pygame.init()

不要在精灵类等子模块里调用pygame.init()，全局只在启动入口初始化一次即可。 #

3. Windows平台特有兼容问题排查 #

如果以上两步修改后仍加载失败，排查两个高频问题：

• 音频格式兼容问题：Pygame对MP3格式的解码依赖系统自带媒体组件，部分精简版Windows缺少对应解码库会加载失败，将MP3转为OGG格式即可获得全平台一致的加载支持，不存在系统依赖问题。
• 文件名/路径问题：Windows默认隐藏已知文件扩展名，你看到的audio_jump.mp3实际可能是audio_jump.mp3.mp3这类命名错误，打开文件管理器的「显示文件扩展名」选项核对真实文件名；同时不要把项目放在含中文、特殊符号的路径下，旧版本Pygame无法解析这类Windows路径。

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