Mac平台PyQt5应用状态栏特殊字符显示异常及崩溃问题

针对你在Mac上用PyQt5 5.10.1 + PyInstaller 3.3.1打包应用遇到的两个问题，我给你整理了对应的解决方案：

1. 文件名中的冒号被替换为下划线的问题 #

这个问题是因为你直接调用了url.fileName()，而Qt的QUrl.fileName()方法会自动对URL中的特殊保留字符（比如冒号）进行转义处理，导致显示异常。

解决方法是跳过URL的文件名提取，直接获取本地文件路径后再提取文件名：

def songChanged(self, media):
    if not media.isNull():
        url = media.canonicalUrl()
        # 获取本地文件系统的原始路径
        local_file_path = url.toLocalFile()
        if local_file_path:
            import os
            # 从路径中提取原始文件名
            original_filename = os.path.basename(local_file_path)
            self.statusBar().showMessage(original_filename)

这样就能保留文件名里的冒号，不会被替换成下划线了——因为toLocalFile()会返回Mac文件系统原生的路径字符串，完全保留原始文件名的格式。

2. 特殊字符（如ω）导致应用崩溃的问题 #

崩溃的核心原因是老旧版本的PyQt5和PyInstaller在处理非ASCII Unicode字符时存在编码兼容问题，尤其是打包后应用的编码环境可能被改变。

可以从两个层面解决：

代码层面：显式处理字符编码 #

修改代码确保文件名被正确解析为Unicode字符串：

def songChanged(self, media):
    if not media.isNull():
        url = media.canonicalUrl()
        local_file_path = url.toLocalFile()
        if local_file_path:
            import os
            original_filename = os.path.basename(local_file_path)
            # 确保字符串是Unicode编码（针对Python 2/3兼容，你的环境大概率是Python 3，但加上更保险）
            if isinstance(original_filename, bytes):
                original_filename = original_filename.decode('utf-8')
            # 显示前可以先确认字符串有效性，避免崩溃
            try:
                self.statusBar().showMessage(original_filename)
            except Exception as e:
                # 兜底处理
                self.statusBar().showMessage(f"无法显示文件名: {str(e)}")

打包层面：指定编码参数 #

用PyInstaller打包时，添加编码参数确保应用运行时使用UTF-8编码：

pyinstaller --encoding=utf-8 your_app.py

如果使用spec文件打包，在spec文件的Analysis部分添加encoding='utf-8'参数：

a = Analysis(
    ['your_app.py'],
    pathex=[],
    binaries=[],
    datas=[],
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=None,
    noarchive=False,
    encoding='utf-8'  # 添加这一行
)

另外，如果你有条件的话，建议升级PyQt5和PyInstaller到较新的版本——老版本的编码兼容问题在后续版本中已经被修复了。

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