企业官网建设流程全解析

Whisky 完整教程：在 macOS Apple Silicon 上运行 Windows 程序与游戏

【免费下载链接】WhiskyA modern Wine wrapper for macOS built with SwiftUI项目地址: https://gitcode.com/gh_mirrors/wh/Whisky

当某个只发 Windows 版的工具没有 Mac 版时，多数人会想到虚拟机，但虚拟机笨重、启动慢、资源占用高。Whisky 走了另一条路：它是一个面向 macOS Apple Silicon 的免费开源 Wine 封装工具，用 SwiftUI 界面在 Mac 上直接运行 Windows 程序与游戏，不需要虚拟机。

项目定位

Whisky 是 Wine 的图形化封装器，用原生 SwiftUI 构建，定位是把 Wine 环境配置的繁琐从用户手里拿走。它构建在 CodeWeavers 的 CrossOver 22.1.1（Wine 发行版）与 Apple 的 Game Porting Toolkit 之上，并集成了 DXVK、msync 等图形与同步优化。它的核心单元叫 Bottle：每个 Bottle 就是一个独立的 Wine 前缀，对应一个隔离的 Windows 环境，多个 Bottle 互不干扰。核心逻辑集中在 WhiskyKit 模块，做二次开发时可以参考该目录。

📋 启动前检查：硬件与前置条件

Whisky 只运行在 Apple Silicon Mac 上，Intel 机型不适用。动手前先对照以下要求确认硬件：

最容易被忽略的前置条件是Rosetta 2。首次启动向导会检查它是否已安装，缺失时通过系统命令自动安装；如果安装失败，设置界面会停在失败状态并要求重试，所以建议确认网络畅通后再启动。

🍷 跑通第一个程序：最短路径

推荐的路径只有一条：Homebrew 安装，首次启动向导会自动完成全部环境步骤。

1. 安装应用：

brew install --cask whisky

2. 打开 Whisky。首次启动界面列出 Rosetta 2 与 WhiskyWine 两项，自动检测并安装，两项都显示已安装后即可进入主界面。
3. 创建 Bottle：填写名称，选择 Windows 版本（默认 Windows 10，可向下选到 XP），确认存放位置。
4. 把安装文件放进 Bottle 的磁盘，双击 .exe 或 .msi，按 Windows 安装向导完成；Whisky 也支持从 Finder 直接打开这类文件。装好的程序会出现在 Bottle 的程序列表中，可直接启动。

其余两种路径结果等价：下载官方发布包拖入应用程序文件夹，或克隆源码git clone https://gitcode.com/gh_mirrors/wh/Whisky后用 Xcode 构建，按习惯选其一即可。

日常怎么用

三个高频操作覆盖绝大多数日常需求。

安装程序：在 Bottle 内直接运行安装文件并跟随向导即可，装好的程序自动进入程序列表。缺字体、公共运行时等依赖时，用 Bottle 页面里的 Winetricks 入口安装对应组件包，命令会在终端中执行，便于观察输出。

启动程序：双击程序列表中的任意项；常用程序可固定到列表顶部，也可以为程序生成带图标的标准 macOS .app 快捷方式，放进启动台后像 Mac 应用一样启动。

管理环境：每个 Bottle 的设置页提供 DXVK（含 HUD 显示级别）、增强同步（msync/esync/none）、AVX、DXR、Windows 版本等开关，改动实时写入该 Bottle 的元数据。习惯命令行的用户，可在应用菜单的 Install CLI 条目安装whisky命令：

whisky list whisky run game /path/to/program.exe

前一条列出全部 Bottle，后一条在名为 game 的 Bottle 中启动指定程序。

使用场景

三种最常见的用途，各自独立建 Bottle 互不干扰。

老旧 Windows 软件：部分行业工具与老办公软件只有 Windows 版。单独建一个 Bottle，按程序文档选择 Windows 版本——多数程序用 Windows 10，更老的软件可试 Windows 7 或 XP。

Windows 游戏：在游戏 Bottle 里启用 DXVK，需要看帧率时把 HUD 设为 fps 档；卡顿可尝试切换同步方式。个别游戏需要额外处理步骤，可对照项目 wiki 中的游戏兼容列表逐项执行。

多环境并存：办公、游戏、开发各用一个 Bottle，互不污染；不再需要时删除对应 Bottle 文件夹即可释放空间。

配置建议速查：

避坑与问题处理

常见问题集中在四类，按现象对照原因处理。

• 首次启动 Rosetta 2 安装失败→ 原因：无网络连接，或系统 softwareupdate 命令被拒 → 处理：确认联网后在设置界面点重试；系统版本过旧则先升级 macOS。
• 程序启动即退出、安装卡住→ 原因：缺依赖组件（DirectX、VC 运行时等），或程序与 Bottle 的 Windows 版本不匹配 → 处理：用 Winetricks 补依赖，或换 Windows 版本重建 Bottle 再装一遍。
• 游戏掉帧、性能不佳→ 原因：未启用 DXVK，或同步方式不合适 → 处理：在 Bottle 设置中开启 DXVK，并把增强同步在 msync 与 esync 之间切换对比。
• 系统或组件更新后原有程序失效→ 原因：README 已说明 Whisky 不再积极维护，环境变化可能破坏兼容性 → 处理：重要 Bottle 定期整目录备份，例如：

cp -R ~/Library/Containers/com.isaacmarovitz.Whisky/Bottles/Office ~/Backup/

Bottle 文件夹本身就是完整环境，备份它即可；恢复时放回原位置就能继续用。

Whisky 把"在 Apple Silicon Mac 上跑 Windows 程序"简化成一行命令加几次点击：brew install --cask whisky，剩下的交给首次启动向导。更多细节与社区入口见项目 README。

【免费下载链接】WhiskyA modern Wine wrapper for macOS built with SwiftUI项目地址: https://gitcode.com/gh_mirrors/wh/Whisky