### Linux Python 编译程序中的中文显示问题解决方案 在 Linux 环境下，如果使用工具如 `PyInstaller` 或其他方法将 Python 程序编译成可执行文件后发现中文无法正常显示，通常是因为缺少字体支持或编码设置不当引起的。以下是详细的分析和解决办法： #### 1. 字体配置不足 当程序被编译为独立的可执行文件时，可能会丢失依赖的操作系统级字体资源。因此，在目标环境中需要手动安装中文字体。 - **安装中文字体** - 对于 Ubuntu/Debian 系统： ```bash sudo apt-get update && sudo apt-get install fonts-wqy-microhei fonts-wqy-zenhei ttf-wqy-microhei ttf-wqy-zenhei ``` - 对于 CentOS/RHEL 系统： ```bash sudo yum install wqy-zenhei-fonts.noarch wqy-microhei-fonts.noarch ``` 这些命令会安装文泉驿正黑 (WenQuanYi Zen Hei) 和文泉驿微米黑 (WenQuanYi Micro Hei)，它们是常用的开源中文字体[^1]。 #### 2. 设置环境变量 某些情况下，即使安装了字体，也需要显式指定字符集来确保正确渲染中文内容。 - 添加以下环境变量到 `.bashrc` 或 `/etc/environment` 文件中： ```bash export LANG="zh_CN.UTF-8" export LANGUAGE="zh_CN:zh" export LC_ALL="zh_CN.UTF-8" ``` 之后重新加载 shell 配置或者重启计算机使更改生效[^3]。 #### 3. 修改源代码以兼容不同平台上的默认编码方式 有时应用程序内部未处理好字符串编码转换也会引发乱码现象。建议修改原始脚本加入如下逻辑判断并调整相应部分： ```python import sys import locale def set_encoding(): try: encoding = locale.getpreferredencoding(do_setlocale=True) if 'utf' not in str(encoding).lower(): raise ValueError('Not UTF-* Encoding') except Exception as e: print(f"Error detected:{e}, forcing utf-8") reload(sys) # For older versions of Python. sys.setdefaultencoding('utf-8') set_encoding() print("你好世界") # Test output Chinese characters. ``` 此段代码尝试获取当前系统的首选编码；如果不是某种形式的UTF，则强制切换至UTF-8模式[^4]。 #### 4. 利用 PyInstaller 构建时嵌入额外数据 如果你正在使用 PyInstaller 工具构建单个可执行文件，并希望其中包含特定字体或其他资源文件，可以通过其 spec 文件机制实现自定义打包行为。 例如创建名为 myscript.spec 的规格描述文档，添加类似下面的内容： ```specfile a = Analysis(['myscript.py'], pathex=['/path/to/project/folder'], datas=[('/usr/share/fonts/truetype/wqy', './fonts')], hiddenimports=[], hookspath=[], runtime_hooks=[]) ... exe = EXE(pyz, a.scripts, [], exclude_binaries=False, name='myscript', debug=False, bootloader_ignore_signals=False, strip=False, upx=True, console=True ) ``` 这里特别注意的是 `datas` 参数，它允许你把本地路径下的字体复制到最终产物里去[^5]。 完成以上操作后再次运行 pyinstaller 命令即可获得改进后的版本。 --- ###