yuzu 中文乱码排查与修复:完整实操指南
yuzu 中文乱码排查与修复:完整实操指南
【免费下载链接】yuzu-downloads项目地址: https://gitcode.com/GitHub_Trending/yu/yuzu-downloads
打开 yuzu 模拟器,主菜单一排排"□□□",中文全变成方块,这就是 yuzu 中文乱码最典型的样子。本文基于 yuzu-downloads 仓库的 Mainline Build - 537296095(2024-03-04)构建,带你从版本核对、字体安装到界面设置,把中文显示一步步调回正常。
乱码的三个常见来源
- 系统里没有中文字体:模拟器自身不携带字体文件,系统缺 CJK 字体(支持中日韩字符的字体)时,所有中文都会渲染成方块。
- 构建版本偏旧:仓库中的 Mainline 构建从 120358cf6(2024-02-27)/) 一路排到 537296095(2024-03-04),越旧的构建越可能带着未修复的显示缺陷,取最新版是基准操作。
- 界面语言与游戏语言混为一谈:菜单里的中文由模拟器渲染,游戏内的中文来自游戏资源,两者需要分开排查。
动手前核对三件事
- 获取文件:
git clone https://gitcode.com/GitHub_Trending/yu/yuzu-downloads- 确认版本:对照 README 构建列表,取 537296095(2024-03-04)目录下的文件。
- 系统字体:Windows 常规安装自带"微软雅黑";Linux 需要单独确认是否装了中文字体。
- 存放路径:安装包放在不含空格和中文的目录,例如 D:\yuzu,避免启动时路径解析出错。
Windows 端:从解压到界面语言设置
🖥️ 安装包为标准 zip,按下面四步走:
- 解压:把
yuzu-windows-msvc-20240304-537296095.zip解压到固定目录,文件在 537296095 构建目录/) 中。 - 启动:双击目录里的
yuzu.exe,首次启动会在%AppData%\yuzu生成用户数据目录。 - 改语言:主菜单进 Options,打开 Settings 的 General 页,把界面语言(UI Language)选为简体中文并保存。
- 重启:关掉再打开 yuzu,菜单文字从方块变成正常中文,这是判断修复生效的第一道关卡。
若 General 页里看不到中文选项,先确认当前界面语言是 English,语言列表会在英文界面下完整显示。
Linux 端:AppImage 命令行部署与字体安装
🐧 AppImage 是单文件可执行程序,免安装,文件取法与 Windows 相同。
- 授权并启动,在终端执行:
chmod +x yuzu-mainline-20240304-537296095.AppImage ./yuzu-mainline-20240304-537296095.AppImage- 看结果:窗口正常弹出即部署成功;若提示 Permission denied,检查 /dev/fuse 是否存在,桌面环境也可直接双击运行。
- 查字体:执行
fc-list :lang=zh,有输出说明系统已有中文字体;输出为空则先装一款:
sudo apt-get install fonts-wqy-microhei- 该命令适用于 Debian/Ubuntu 系,其他发行版换成对应的字体包名。装完字体后重启 yuzu,按 Windows 小节第 3 步把界面语言设为简体中文。
二次问题对照表
| 现象 | 可能原因 | 对策 |
|---|---|---|
| 菜单是中文,个别标点仍是方块 | 当前字体缺少部分 CJK 字形(如全角标点) | 再装一款字形更全的中文字体,让系统有多套字体可回退 |
| 换到最新构建仍乱码 | 旧用户数据里的设置未刷新 | 把用户数据目录(%AppData%\yuzu 或 ~/.yuzu)改名备份后重启,再重新设置一次 |
| 界面正常,游戏内中文乱码 | 游戏内文字由游戏自身渲染,ROM 字体缺失或区域不符 | 换一份完整的中文版 ROM 验证,界面修复不覆盖游戏内显示 |
修复确认与后续维护
✅ 确认是否修好,看三条:
- 主菜单、设置面板、文件对话框全部为简体中文,无方块、无缺笔。
- 载入一款含中文的游戏,检查游戏菜单与字幕;若此处仍乱码,问题在 ROM 资源,不在 yuzu 配置。
- 重启一次,设置仍然生效,中文不回退。
长期维护两条:
- 升级前先记录当前构建号(构建目录名中的哈希即构建号),出问题时能直接定位是哪个版本。
- 系统里备两套中文字体,某套缺字形时渲染可自动回退到另一套。
把上面几步走一遍,豆腐块就该退场了,剩下的体验交给游戏本身。
【免费下载链接】yuzu-downloads项目地址: https://gitcode.com/GitHub_Trending/yu/yuzu-downloads
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考