15分钟跑通Whisky在Apple Silicon Mac上运行Windows程序的操作手册【免费下载链接】WhiskyA modern Wine wrapper for macOS built with SwiftUI项目地址: https://gitcode.com/gh_mirrors/wh/Whisky被Windows版工具卡住时的一个选择你手上这台Mac偏偏要跑一个只有Windows版的工具。装虚拟机嫌卡装双系统嫌烦自己翻Wine的命令行更劝退。Whisky就是为这个场景做的一个原生SwiftUI应用让你在Mac上运行Windows程序——建个容器把安装文件拖进去全程不用碰命令行。它底层用的是CrossOver 22.1.1和苹果官方的Game Porting ToolkitD3DMetal图形和游戏兼容性有官方技术打底不是裸跑的Wine。Whisky 运行 Windows 程序的3项前提与2条装法项目要求备注芯片Apple SiliconM1/M2/M3Intel Mac不支持系统macOS Sonoma 14.0及以上代码里写死了macOS 14基线存储WhiskyWine加一个容器预留2GB以上装得越多容器越大Intel芯片的Mac没有Whisky这条路只能考虑虚拟机或老式Wine方案。另有一句实话README里已注明项目不再积极维护某个老程序哪天跑不动了别太意外。主路径推荐brew install --cask whisky✅ 一条命令装好后续更新也由Homebrew接管最省心。备路径手动从项目仓库下载最新的Whisky应用包把Whisky.app拖进应用程序文件夹首次启动被拦截的话到系统设置→隐私与安全性里允许动手前搞懂3个词Bottle、WhiskyWine与DXVKBottle容器每个Bottle就像一个样品箱里面封着一套完整的小Windows有自己的系统文件、自己的注册表、自己的C盘。动一箱不碰另一箱删一箱全部归零。WhiskyWine运行时Whisky本身只是底盘WhiskyWine才是发动机——Whisky定制的Wine运行时首次启动时下载安装装一次所有容器共用。DXVK图形转换层给图形走一条绕路把DirectX调用改走Vulkan的中转站再接入Metal的本地路网DX9/10/11游戏收益最大。只记一句话Whisky管界面WhiskyWine管执行Bottle管边界。用Whisky运行Windows程序一条12步的操作流打开Whisky → 首次启动进入引导页 → 应用不带运行时这一步就是装发动机Rosetta 2检查 → 显示已装或出现一键安装按钮 → 没装就点它几分钟的事下载WhiskyWine → 进度条开始走 → ⚠️ 中途断网别慌重启Whisky它会检测未完成状态并接着来安装WhiskyWine → 解压装完引导自动关闭点工具栏左上角 → 弹出新建容器窗口输入容器名比如办公 → 名字不能为空为空时创建按钮是灰的Windows版本保持默认Windows 10→ 对大多数程序最稳妥存放路径保持默认 → 默认在应用容器目录内点浏览可自定义点创建 → 主界面容器图标亮起来 → ⚠️ 首次创建要初始化一整套Windows前缀几分钟属正常点底部运行选.exe/.msi安装文件也可以直接把文件拖进窗口 → 弹出Windows安装向导一路下一步 → 程序进入开始菜单列表并被自动Pin到容器首页双击首页里的程序 → Windows窗口出现收工GUI能做的命令行都能做。在设置页启用CLI工具后whisky命令直接可用whisky list # 列出所有容器及Windows版本 whisky create 办公 # 新建容器默认Win10 whisky run 办公 /path/to/setup.exe # 在指定容器里跑程序 eval $(whisky shellenv 办公) # 把容器环境变量加载进当前终端掉帧、高占用、不兼容3类症状的对症配置掉帧DirectX 9/10/11游戏 先查同步模式配置页里同步模式应为msync默认值个别游戏在msync下异常就退回esync试试。再打开DXVKDXVK Async默认就是开的保持即可。然后打开Metal HUD如果GPU浮层打满而CPU闲着瓶颈在渲染侧去查游戏自身设置。预期帧数和稳定性上一个台阶。这个思路可以在WhiskyKit/Sources/WhiskyKit/Whisky/BottleSettings.swift里看到——msync开启时会同时写入WINEESYNC1因为D3DMetal检测到esync会改变行为必须谎报一次。CPU占用高、风扇狂转先确认同步模式不是nonemsync的本事就是压住多线程空转。再关掉macOS侧的后台高占用应用。再看容器所在磁盘是不是慢盘游戏容器挪到更快的盘上创建时改路径就行。预期风扇噪音降一档。某类程序起不来或报错先切Windows版本老程序可能认Win7甚至XP配置页的版本下拉框随时可换。再补运行库底部Winetricks按钮在dlls和apps分类里装vcrun、dotnet这类常见组件。程序明确需要AVX指令集、系统又是macOS 15以上可以试AVX开关带警告谨慎开。预期换版本能解决大半起不来的情况省得一个个盲试。3种人3套配置按你的场景取用如果你是办公用户Office、财务软件 推荐配置Windows 10 默认msync其余全不动。 最容易踩的坑① 不同项目挤在一个容器里出问题没法隔离② 忘了容器存在哪默认在~/Library/Containers下的应用容器里要备份时找不到。 进阶才需要whisky shellenv把容器环境灌进终端绕过GUI直接跑单个exe。如果你是游戏玩家 推荐配置Windows 10/11 msync DXVK游戏单独开容器。 最容易踩的坑① 非DirectX游戏也开DXVK纯属多此一举② 录屏或展示时忘了关DXVK HUD和Metal HUD画面多了层浮层。 进阶才需要M3/M4芯片上配置页会出现DXR开关光追类游戏值得一试。如果你是开发/测试 推荐配置Windows 10 打开Retina模式同步用默认值。 最容易踩的坑① 开着Metal HUD录教程浮层进了成片② Pin了可移动磁盘上的程序拔盘后图标还在——这是设计如此可移动磁盘的Pin会被单独记住盘插回来自动复活。 进阶才需要Metal Trace抓取GPU帧跟踪用来分析渲染行为。用户推荐配置组合常见坑进阶项办公Win10 默认msync多项目挤一个容器shellenv进终端跑游戏Win10/11 msync DXVK非DirectX游戏开DXVKM3/M4试DXR开发Win10 Retina录制忘关HUDMetal Trace抓帧起不来别卸载4个高频故障按图排查装完程序启动不了最可能原因容器Windows版本和程序年代不匹配或缺运行库。 30秒检查打开容器的Winetricks看vcrun、dotnet这类组件装没装。 彻底解决配置页换Windows版本Win10、Win7、Win11逐个试→ Winetricks装常用组件 → 重启程序验证 → 还不行就打开容器页面和底部终端看具体报错输出。中文界面全是方块最可能原因容器缺CJK字体。 30秒检查Winetricks的fonts分类里装一个中文字体组件立刻看效果。 彻底解决Winetricks装字体包 → 配置页点winecfg把容器区域语言设为简体中文 → 重启容器生效。Bottle一直卡在创建中最可能原因首次初始化前缀本来就慢不是卡死。 30秒检查点C盘按钮打开容器目录看文件夹大小还在不在涨。 彻底解决先耐心等几分钟 → 超过10分钟毫无动静再删除重建 → 检查磁盘剩余空间容器尽量放在空间充足的卷上。窗口模糊发虚最可能原因Retina模式没开或DPI停在默认96。 30秒检查配置页打开Retina开关。 彻底解决仍模糊就打开配置页的DPI设置滑到192以上页面内置预览能立刻看到字体大小变化。排查总原则查配置 → 补组件 → 看日志 → 去提问提问时附上报错截图和复现步骤回复效率翻倍。4个目录看懂源码4步参与贡献目录职责Whisky/Views/全部SwiftUI页面建容器、配置、程序列表、首次引导Whisky/Utils/小工具件Winetricks调用、快捷方式、CLI工具安装WhiskyKit/Sources/WhiskyKit/核心引擎Bottle数据模型、Wine调用、配置序列化WhiskyKit/Sources/WhiskyKit/PE/内置Windows PE文件解析器程序图标和快捷方式都靠它读WhiskyCmd/Main.swiftCLI实现list、create、run、shellenv等6个子命令想参与进来4步就够同行之间说点实在的git clone https://gitcode.com/gh_mirrors/wh/Whisky读CONTRIBUTING.mdXcode 15构建SwiftLint零违规是硬门槛从最小可提交单元入手修一个typo、补一行英文文案key加在Whisky/Localizable.xcstrings具体翻译走平台协调PR里只加英文key、修一个UI bug附截图CI通过后提PR等评审现在去做这3件事今天brew install --cask whisky建出第一个Bottle装上那个惦记很久的Windows程序。这周在设置里启用命令行用whisky run把同一个程序以CLI方式再跑一遍感受界面和命令是同一套数据模型的两副面孔。之后顺手clone一份仓库改一行typo提你的第一个PR。Windows世界没你想的那么远——打开终端敲下那条brew命令15分钟后你的Mac里就多了一台Whisky。【免费下载链接】WhiskyA modern Wine wrapper for macOS built with SwiftUI项目地址: https://gitcode.com/gh_mirrors/wh/Whisky创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
