Apple silicon 或 Intel
M1/M2/M3 及更新芯片使用 arm64 zip，Intel Mac 使用 x86_64 zip。不要因为一次启动失败就随意换架构。
最新
在 macOS 设置 Dusk Light
M 系列 Mac 使用 Apple silicon zip，Intel Mac 使用 x86_64 zip。下载后从解压出的 app 启动 Dusklight，再选择自己的受支持 GameCube 或 Wii 转储。下面的说明会覆盖 Gatekeeper、Metal、文件校验和 macOS 常见问题。
最后核对: 2026-09-19，对照 GitHub v2.0.0
选择正确的 macOS 构建
v2.0.0 分别提供 Apple silicon 和 Intel 安装包，macOS 需要支持 Metal。请使用自己的 GameCube 或 Wii 光盘转储；支持零售版光盘，韩版 Wii 除外。Wii 光盘仍使用 GameCube 界面。
安装步骤
- 01下载与你 Mac 匹配的 macOS 构建：Apple silicon 用 ARM64，Intel Mac 用 x86_64。也可以用 Homebrew：brew install dusklight。
- 02如果下载的是 zip，双击解压得到 Dusklight.app。
- 03把 Dusklight.app 移到 Applications，或直接从解压目录启动；如果 macOS 阻止首次启动，用 Finder 右键 Open。
- 04打开 Dusklight，选择 Select Disc Image，选中你自己的 GameCube 或 Wii 光盘转储（韩版 Wii 除外）。
开始前检查
Metal 支持
macOS 路线依赖 Metal。旧款 Intel 集成显卡或通过补丁运行新系统的 Mac，更应先查看问题记录，再安排长时间游玩。
自己的支持转储
Dusklight 不包含受版权保护的游戏资源。请使用自己的 GameCube 或 Wii 光盘转储，韩版 Wii 除外；不支持 Twilight Princess HD。
官方文件大小
v2.0.0 中 Apple silicon zip 为 36.6 MiB，Intel zip 为 38.2 MiB。文件名或大小明显不对时先回到 GitHub。
校验 macOS 归档
macOS 首次运行时容易被 Gatekeeper 提示打断。更稳妥的做法是先确认下载来源，再决定是否批准打开。
校验 Apple silicon zip
shasum -a 256 ./Dusklight-v2.0.0-macos-arm64.zip在下载目录运行，可与 GitHub 发布资产元数据中的 SHA-256 记录对比。
校验 Intel zip
shasum -a 256 ./Dusklight-v2.0.0-macos-x86_64.zipIntel Mac 用户用这一条，避免后续更新时混淆 arm64 与 x86_64。
查看 Gatekeeper 状态
spctl --assess --verbose ./Dusklight.app解压后可用于理解 macOS 为什么提示批准，但它不能替代来源校验。
macOS 注意事项
- M 系列 Mac 使用 Apple silicon，Intel Mac 使用 x86_64。
- 通过 Gatekeeper 批准前，先确认文件来自 GitHub 官方发布页。
- Metal 支持是实际硬件要求的一部分。
- 不要把游戏转储放进 app bundle，避免更新时混乱。
- Dusk Light 不托管 ROM、ISO、光盘镜像或版权资产。
其他官方构建
继续查看同语言平台指南
在当前语言中切换到其他 Dusk Light 安装页面，比较文件大小、更新时间和平台限制。
v2.0.0 变化
发布于 2026 年 9 月 19 日
GitHub 将 v2.0.0 标为最新稳定版，并分别提供 Apple silicon 与 Intel 构建。
macOS 支持与性能
v1.4.0 重构了渲染器性能并修复 macOS 12 支持。排查旧启动或性能问题前先使用 v2.0.0。
模组、纹理与存档
v2.0.0 新增模组浏览器和存档管理器，并改进替换纹理的流式加载与缓存。纹理包或图形后端出错时，请记录 Mac 型号、macOS 版本、构建架构及 Metal 错误。
macOS 问题追踪记录
问题 #826: Metal 启动崩溃
开放中该报告描述了 RenderPipelineMTL / Metal pipeline 创建阶段的 macOS 启动崩溃，适合作为旧图形硬件兼容风险证据。
打开来源问题 #1715: 键盘绑定
上游已关闭项目于 2026 年 8 月 4 日关闭了这条按键绑定问题。它是历史记录，不是已确认的 v2.0.0 回归。若 Return 或 Shift 仍无法使用，请记录 macOS 版本、键盘布局和当前 Dusklight 构建。
打开来源问题 #1717: WUP-028 转接器
开放中报告称 Wii U GameCube adapter 在 Dolphin 可用但 macOS Dusklight 构建中不可用，应提前验证手柄路径。
打开来源问题 #1832: Hidden Village 崩溃
已在 v1.4.0 完成v1.4.0 已修复取得 Ilia's Charm 后离开 Hidden Village 的崩溃。该问题记录只用于说明旧构建的历史情况。
打开来源事实来源
这里列出的所有文件都指向 TwilitRealm/dusklight 在 GitHub 发布的官方资产。Dusk Light 不镜像二进制文件，也不托管受版权保护的游戏数据。