1. 从“Madeira”这个名字说起它到底想解决什么问题第一次看到“Madeira”这个项目名很多人会以为是葡萄酒或者旅游相关的项目但结合热搜词里的 Wine、FEX-Emu、DXMT、iOS、x86-64 这几个关键词方向就很清楚了——这是一个围绕在非 x86 平台尤其是 ARM 架构的移动设备上运行 Windows 应用与游戏的兼容层项目。Madeira 这个名字本身是葡萄牙的一座岛屿也是马德拉酒的产地用酒名来命名兼容层项目在开源圈子里其实挺常见属于一种“喝着酒把活干了”的幽默。先把定位说清楚Madeira 要解决的核心问题是——你手上有一台 ARM 设备比如搭载 Apple Silicon 的 Mac、iPad或者高通芯片的安卓设备但你需要的某个 Windows 软件或游戏只有 x86-64 版本怎么让它跑起来传统做法是虚拟机但虚拟机要装完整 Windows 系统资源占用大、启动慢、图形性能损耗严重。Madeira 走的是另一条路用 Wine 做 Windows API 翻译用 FEX-Emu 做 x86-64 到 ARM64 的指令翻译用 DXMT 把 DirectX 调用翻译成 Metal三层叠加让 Windows 程序在 ARM 设备上“直接”运行。这套组合拳的意义在于它把“跨架构运行 Windows 程序”这件事拆成了三个可以独立演进的层次。Wine 负责 API 层FEX-Emu 负责指令层DXMT 负责图形层。每一层都可以单独替换或升级比如图形层未来可以换成别的后端指令层也可以换成 Box64 之类的方案。这种分层设计是 Madeira 最值得关注的地方也是它区别于“一体化模拟器”的核心思路。适合谁来参考三类人一是想在 Mac 或 iPad 上玩 Windows 游戏的玩家二是做跨平台兼容性测试的开发者三是对 Wine、指令翻译、图形翻译技术感兴趣的技术研究者。哪怕你只是想知道“为什么我的 Wine 里中文全是乱码”这篇文章里的排查思路也能直接用上。2. 整体架构拆解三层翻译到底怎么配合2.1 Wine 层Windows API 的“翻译官”Wine 的全称是“Wine Is Not an Emulator”它不模拟硬件而是把 Windows 的系统调用翻译成宿主系统的调用。比如 Windows 程序调用CreateFileWine 会把它翻译成 Linux 或 macOS 上的open。这样做的好处是性能损耗小因为不需要模拟整个 CPU 和硬件环境。但 Wine 有个前提它假设宿主 CPU 和 Windows 程序的 CPU 架构是一样的。在 x86 的 Linux 上跑 x86 的 Windows 程序Wine 直接就能工作。但在 ARM 设备上Windows 程序是 x86-64 指令宿主是 ARM64 指令Wine 自己搞不定指令翻译这就需要 FEX-Emu 出场。Wine 在 Madeira 里的角色是“API 翻译层”它不关心指令是什么架构只关心 API 调用怎么映射。这也是为什么 Madeira 能把 Wine 和 FEX-Emu 组合起来——两者职责不重叠。2.2 FEX-Emu 层x86-64 到 ARM64 的“实时翻译”FEX-Emu 是一个用户态的 x86-64 指令翻译器它把 x86-64 的机器码实时翻译成 ARM64 的机器码。和 QEMU 这种全系统模拟器不同FEX-Emu 工作在用户态不需要模拟整个操作系统所以性能更好。FEX-Emu 的核心技术是JIT即时编译程序第一次执行某段 x86-64 代码时FEX-Emu 把它翻译成 ARM64 代码并缓存起来下次再执行同一段代码就直接用缓存。这样翻译开销被摊薄实际运行时的性能损耗可以控制在可接受范围内。但 FEX-Emu 也有短板它对 x86-64 指令集的支持是逐步完善的某些较新的指令比如 AVX-512可能支持不完整导致部分程序崩溃或性能异常。这是使用 Madeira 时最常见的兼容性问题来源之一。2.3 DXMT 层DirectX 到 Metal 的“图形桥梁”DXMT 的全称是“DirectX Metal Translation”它把 Windows 程序发出的 DirectX 调用翻译成 Apple Metal 的调用。为什么是 Metal因为 Madeira 的主要目标平台之一是 Apple Silicon 设备而 Metal 是 Apple 平台的原生图形 API性能最好。DXMT 支持 DirectX 11 和部分 DirectX 12 功能覆盖了大多数 Windows 游戏和图形应用的需求。它的工作方式和 DXVKDirectX 到 Vulkan 的翻译层类似只是目标 API 从 Vulkan 换成了 Metal。三层配合的流程是这样的Windows 程序发出 x86-64 指令和 DirectX 调用FEX-Emu 把指令翻译成 ARM64Wine 把 Windows API 调用翻译成宿主系统调用DXMT 把 DirectX 调用翻译成 Metal。三层各司其职最终让 Windows 程序在 ARM 设备上跑起来。注意这三层的版本兼容性很关键。Wine 的版本、FEX-Emu 的版本、DXMT 的版本必须匹配否则可能出现“API 翻译对了但指令翻译错了”或者“指令翻译对了但图形调用翻译错了”的情况。建议使用 Madeira 官方推荐的版本组合不要随意混搭。3. 核心细节解析从乱码到开发者模式的实操要点3.1 Wine 中文乱码的根因与修复热搜词里“wine 乱码”和“wine 栏是乱码”出现频率很高说明这是 Wine 用户最常遇到的问题。乱码的根因是字体缺失和编码不匹配。Wine 默认使用宿主系统的字体来渲染 Windows 程序的文字。如果宿主系统没有安装 Windows 程序所需的中文字体比如宋体、微软雅黑Wine 就会用默认字体替代导致中文显示为方块或乱码。另外Wine 的 locale 设置如果和程序的编码不匹配也会导致乱码。修复方法分三步安装中文字体把 Windows 的宋体simsun.ttc、微软雅黑msyh.ttf等字体复制到 Wine 的字体目录通常是~/.wine/drive_c/windows/Fonts/。配置 Wine 的 locale在终端执行export LANGzh_CN.UTF-8和export LC_ALLzh_CN.UTF-8确保 Wine 使用中文编码。修改注册表用wine regedit打开注册表找到HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\FontSubstitutes把MS Shell Dlg和MS Shell Dlg 2的值改成已安装的中文字体名。实测下来这三步做完绝大多数中文乱码问题都能解决。如果还有个别程序乱码可能是程序自己带了字体文件需要单独处理。3.2 iOS 开发者模式的开启与自动化热搜词里“ios开发者模式”和“ios 26.3.1怎么开发者模式”说明很多人在 iOS 设备上做开发或测试时卡在了开发者模式这一步。iOS 从 16 版本开始开发者模式默认是关闭的需要手动开启。开启步骤进入“设置”-“隐私与安全性”-“开发者模式”打开开关然后重启设备。重启后会弹出确认窗口点击“打开”并输入锁屏密码即可。但这里有个坑开发者模式只有在设备连接过 Xcode 或安装了开发者证书的应用后才会出现。如果你在设置里找不到“开发者模式”选项说明设备还没有被“激活”开发者状态。解决办法是用数据线把设备连到电脑打开 Xcode在“Devices and Simulators”里信任设备然后开发者模式选项就会出现。对于 iOS 自动化测试开启开发者模式后还需要在“设置”-“开发者”里打开“Enable UI Automation”否则自动化脚本无法控制界面。3.3 Xcode 打包突然变慢的排查思路“xcode打包ios突然很慢如何解决”这个热搜词反映了一个常见问题Xcode 打包速度突然下降。可能的原因有四个DerivedData 缓存过大Xcode 的缓存目录~/Library/Developer/Xcode/DerivedData如果积累了大量旧数据会拖慢编译速度。解决方法是定期清理或者用xcodebuild clean命令清理。索引服务卡住Xcode 的代码索引服务SourceKit有时会卡住导致编译变慢。重启 Xcode 或者删除~/Library/Developer/Xcode/UserData/下的索引文件可以解决。证书和描述文件问题如果证书过期或描述文件不匹配Xcode 会反复尝试连接 Apple 服务器验证导致打包变慢。检查证书有效期和描述文件状态。磁盘空间不足Xcode 编译需要大量临时空间磁盘剩余空间低于 10% 时编译速度会明显下降。排查顺序建议从清理缓存开始然后检查证书最后看磁盘空间。大多数情况下清理 DerivedData 就能解决问题。3.4 iOS 浏览器唤起安装 App 的实现方式热搜词里“ios浏览器唤起安装app”和那个带 aff_code 的下载链接说明很多人关心怎么从网页跳转到 App 安装。iOS 上从浏览器唤起安装有两种方式第一种是Universal Links通过配置apple-app-site-association文件让网页链接直接打开已安装的 App。如果 App 没安装则跳转到 App Store。第二种是自定义 URL Scheme比如myapp://网页里用 JavaScript 尝试打开这个 Scheme如果 App 已安装则直接打开否则跳转到下载页。但 iOS 对 URL Scheme 的限制越来越严Safari 可能会拦截或弹出确认框。对于企业级分发或测试分发还可以用itms-services协议通过itms-services://?actiondownload-manifesturl...的方式安装 IPA 文件。但这种方式需要 HTTPS 证书和正确的 manifest 配置否则会安装失败。注意从 iOS 16 开始Safari 对自动跳转的限制更严格建议在用户点击按钮后再触发跳转不要用window.location自动跳转否则可能被拦截。4. 实操过程从零搭建 Madeira 运行环境4.1 环境准备与依赖安装假设你在 Apple Silicon 的 Mac 上搭建 Madeira 环境步骤如下第一步安装 Homebrew。如果还没装在终端执行/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)第二步安装 Wine。Madeira 推荐使用 Wine 的特定版本不要直接用 Homebrew 的默认版本brew install --cask --no-quarantine wine-stable第三步安装 FEX-Emu。FEX-Emu 在 macOS 上的安装相对复杂需要从源码编译或者下载预编译的二进制包brew install fex-emu如果 Homebrew 没有 FEX-Emu 的 formula需要从 GitHub Releases 下载对应的二进制包解压后放到/usr/local/bin/或~/bin/下。第四步安装 DXMT。DXMT 通常作为 Wine 的插件存在需要把编译好的dxmt.dll和d3d11.dll等文件放到 Wine 的drive_c/windows/system32/目录下。第五步配置环境变量。在~/.zshrc或~/.bashrc里添加export WINEARCHwin64 export WINEPREFIX~/.wine-madeira export FEX_ROOTFS~/.fex-emu/RootFS export FEX_APP_CONFIG~/.fex-emu/Config.json这些环境变量的作用是指定 Wine 使用 64 位架构指定 Wine 的 prefix 目录指定 FEX-Emu 的根文件系统和配置文件位置。4.2 初始化 Wine Prefix 与安装 Windows 程序环境变量配置好后执行wineboot --init这个命令会初始化 Wine 的 prefix 目录创建drive_c等目录结构。初始化完成后可以用winecfg打开 Wine 的配置界面检查 Windows 版本设置建议设为 Windows 10和图形设置。安装 Windows 程序时直接用wine命令运行安装包wine setup.exe如果安装包是 x86-64 架构FEX-Emu 会自动介入翻译指令。你可以在终端看到 FEX-Emu 的日志输出确认翻译是否正常。安装完成后运行程序wine C:\Program Files\YourApp\app.exe如果程序启动后黑屏或崩溃先检查 DXMT 是否正确加载。可以在终端设置WINEDEBUGd3d11查看 DirectX 调用的日志确认 DXMT 是否在正常工作。4.3 图形性能调优与参数选择DXMT 的性能调优主要涉及三个参数Metal 命令队列数量默认是 1增加到 2 或 3 可以提升多线程渲染性能但会增加显存占用。建议根据设备显存大小调整8GB 显存的设备可以设为 2。着色器缓存大小DXMT 会缓存翻译后的 Metal 着色器缓存越大重复渲染越快。默认是 256MB可以增加到 512MB 或 1GB。垂直同步如果游戏帧率超过显示器刷新率开启垂直同步可以减少撕裂但会增加输入延迟。竞技类游戏建议关闭单机游戏建议开启。这些参数可以在 DXMT 的配置文件里修改通常是~/.wine-madeira/drive_c/windows/system32/dxmt.conf或者通过环境变量传递。实测下来在 M1 Mac 上运行 DirectX 11 游戏DXMT 的翻译损耗大约在 15% 到 25% 之间具体取决于游戏的图形复杂度。DirectX 12 游戏的损耗更大因为 DX12 的 API 更复杂翻译难度更高。5. 常见问题与排查技巧实录5.1 程序启动崩溃的排查流程程序启动崩溃是 Madeira 使用中最常见的问题排查流程如下现象可能原因排查方法解决方案启动后立即崩溃无日志FEX-Emu 不支持某条 x86-64 指令设置FEX_LOG_LEVELdebug查看指令翻译日志升级 FEX-Emu 到最新版本或等待指令支持启动后黑屏有声音DXMT 图形翻译失败设置WINEDEBUGd3d11查看 DirectX 日志检查 DXMT 版本是否匹配尝试切换 DirectX 版本启动后报错“缺少 DLL”Wine 缺少必要的运行库用winecfg查看已安装的库安装对应的运行库如 vcrun2019、dotnet48启动后中文乱码字体缺失或编码不匹配检查 Wine 字体目录和 locale 设置安装中文字体设置LANGzh_CN.UTF-8排查时建议从日志入手不要盲目重装。Wine 和 FEX-Emu 的日志信息很详细能直接定位到问题所在。5.2 性能异常的优化技巧如果程序能运行但性能异常可以从四个方面优化第一关闭不必要的 Wine 服务。Wine 默认会启动一些后台服务如wineserver、explorer.exe这些服务会占用 CPU 和内存。可以在winecfg里关闭不需要的服务。第二调整 FEX-Emu 的 JIT 缓存大小。FEX-Emu 的 JIT 缓存默认是 128MB对于大型游戏可能不够用导致频繁重新翻译。可以在Config.json里把JITCacheSize增加到 256MB 或 512MB。第三使用 DXMT 的异步着色器编译。DXMT 支持异步编译着色器可以避免着色器编译时的卡顿。在配置文件里开启AsyncShaderCompilation选项。第四限制帧率。如果游戏帧率远高于显示器刷新率多余的帧会浪费 GPU 资源。用 DXMT 的帧率限制功能把帧率限制在显示器刷新率附近。5.3 独家避坑经验踩过的坑分享几个不要用最新版的 Wine。最新版 Wine 可能引入了新的 bug而 Madeira 的 FEX-Emu 和 DXMT 可能还没适配。建议使用 Madeira 官方推荐的 Wine 版本通常是稳定版而不是开发版。FEX-Emu 的 RootFS 要匹配宿主系统。FEX-Emu 需要一个 RootFS 来提供 x86-64 的基础库这个 RootFS 的版本要和宿主系统的 glibc 版本匹配否则会出现符号找不到的错误。DXMT 的 DLL 要放在正确目录。DXMT 的d3d11.dll、dxgi.dll等文件必须放在 Wine prefix 的system32目录下不能放在程序自己的目录里否则 Wine 不会加载。iOS 设备模拟器不能替代真机测试。热搜词里“ios设备模拟”出现多次但模拟器和真机的行为差异很大尤其是图形性能和网络请求。建议在真机上做最终测试。6. 影响范围与扩展思路Madeira 这套方案的影响范围其实超出了“在 ARM 上跑 Windows 游戏”这个场景。它的三层架构API 翻译 指令翻译 图形翻译可以推广到很多类似场景。比如如果你想在 RISC-V 设备上运行 x86 程序可以把 FEX-Emu 换成支持 RISC-V 的指令翻译器Wine 和 DXMT 可以复用。如果你想在 ARM 服务器上运行 Windows 的服务器软件也可以用类似的组合只是图形层可以换成更轻量的方案。从技术演进的角度看Madeira 的价值在于它验证了“分层翻译”的可行性。每一层都可以独立优化比如 FEX-Emu 可以针对特定游戏做指令优化DXMT 可以针对特定 GPU 做着色器优化。这种模块化设计比一体化模拟器更灵活也更容易维护。对于开发者来说如果想参与 Madeira 生态可以从三个方向入手一是给 FEX-Emu 提交指令支持的补丁二是给 DXMT 提交图形 API 的翻译优化三是给 Wine 提交 Windows API 的兼容性修复。每个方向都有大量的工作可以做而且都能直接改善用户体验。我个人在实际操作中的体会是Madeira 这类项目的门槛不在“能不能跑”而在“跑得稳不稳”。第一次跑通可能只需要几个小时但要让某个特定游戏稳定运行可能需要反复调试几天。耐心和日志分析能力比技术栈本身更重要。