使用PyInstaller打包Mac应用时如何配置LANG环境变量？

你已经精准定位了问题根源，太赞了——Mac下用PyInstaller打包出的.app运行时，因为没获取到LANG环境变量，Python默认用ASCII编码处理带重音的字符，直接触发了UnicodeEncodeError。下面给你两个靠谱的解决办法：

方法一：修改Info.plist注入环境变量 #

直接在PyInstaller的spec文件里，给BUNDLE部分的info_plist字典添加LSEnvironment配置，让Mac启动.app时自动加载指定的LANG变量：

修改后的spec文件对应部分代码如下：

app = BUNDLE(exe,
             name='My App.app',
             icon=icon,
             bundle_identifier='com.me.myapp',
             info_plist={
                 'NSHighResolutionCapable': 'True',
                 # 添加这一段，设置UTF-8编码的locale
                 'LSEnvironment': {
                     'LANG': 'en_US.UTF-8'  # 你也可以换成fr_FR.UTF-8这类你需要的UTF-8 locale
                 }
             },)

这个方法最简洁，不用改应用代码，直接借助Mac的App Bundle配置来搞定。

方法二：用Runtime Hook强制设置编码 #

如果方法一不生效，你可以写个运行时钩子脚本，在应用启动时强制设置LANG环境变量和Python默认编码：

1. 新建一个名为fix_lang_hook.py的文件，内容如下：

import os
import sys

def setup_lang_env():
    # 如果LANG没设置，强制指定UTF-8的locale
    if not os.environ.get('LANG'):
        os.environ['LANG'] = 'en_US.UTF-8'
        # Python3.6里sys.setdefaultencoding已经移除了，加个异常处理兼容一下
        try:
            reload(sys)
            sys.setdefaultencoding('utf-8')
        except AttributeError:
            pass

setup_lang_env()

2. 在spec文件的Analysis部分，把这个钩子添加到runtime_hooks列表里：

a = Analysis(['../main.py'],
             pathex=['.'],
             binaries=[],
             datas=[],
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=['fix_lang_hook.py'],  # 这里加入钩子文件
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher)

之后重新用PyInstaller打包：pyinstaller 你的spec文件名.spec

问题背后的原因 #

直接运行dist/myapp可执行文件时，它会继承终端的环境变量（包括LANG）；但.app包是通过Mac的Launch Services启动的，默认不会加载终端的环境变量配置，导致Python检测不到UTF-8的locale，只能回退到ASCII编码，处理带重音的字符自然就崩溃了。

你可以在应用里加一行代码验证是否生效：

import os
print(f"当前LANG环境变量：{os.environ.get('LANG')}")

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