Dolphin 安装上手教程：5 分钟从源码跑通 GameCube 与 Wii 模拟器-平芜编程栈

Dolphin 安装上手教程：5 分钟从源码跑通 GameCube 与 Wii 模拟器

【免费下载链接】dolphinDolphin is a GameCube / Wii emulator, allowing you to play games for these two platforms on PC with improvements.项目地址: https://gitcode.com/GitHub_Trending/do/dolphin

想在电脑上重温 GameCube 和 Wii 游戏？装不好、找不到系统文件、手柄不识别，是新手卡壳最多的三处。Dolphin 是一款开源的 GameCube/Wii 模拟器，支持 Windows、Linux、macOS 和 Android，可以把这两台主机上的经典游戏搬进你的电脑，还附带画质与性能增强。下面先带你用最短路径装好它，再按平台拆要点，最后按「现象→原因→修复」过一遍高频坑位。

先跑起来：最短安装路径

先看硬件门槛，以官方文档 Readme.md 给出的系统要求为准：

平台	系统版本	处理器	图形要求
Windows	10（1903 或更高）	支持 SSE2 指令集	较新型显卡，Direct3D 11.1 / OpenGL 3.3 级别
macOS	11.0 或更高	支持 SSE2	OpenGL 3.3 级别
Linux	常见发行版均可	2008 年前后的双核 3GHz 即可，越新越好	OpenGL 3.3 起步，4.4 体验更佳
Android	7.0 或更高	64 位（ARMv8 / x86-64）	OpenGL ES 3.0 起步

想要 4K 分辨率下稳定高帧率，建议 6 核以上 CPU 加中高端独立显卡，具体以实际机型为准。

克隆仓库并补齐依赖模块

git clone https://gitcode.com/GitHub_Trending/do/dolphin cd dolphin git submodule update --init --recursive

子模块是仓库引用的第三方代码，漏了这一步后面会缺文件，别跳过。

配置构建

cmake -B build

CMake 是构建工具的项目配置器：它读取你的系统环境，生成一套适合本机编译的构建脚本。

编译并启动

cmake --build build -j $(nproc) ./build/Binaries/dolphin-emu

编译完成后到Binaries目录找可执行文件。主界面能打开就算跑通了；在终端输入./build/Binaries/dolphin-emu --version能看到版本号，同样说明安装成功。

平台差异：一张表看全，重点讲 Linux

平台	推荐程度	最短路径	备注
Linux	推荐	CMake 三行命令	上文已完整给出
Windows	推荐	Visual Studio 生成 Release	也可做 NSIS 安装包
macOS	可用	官方发布版或通用二进制脚本	开发者向，细节以官方文档为准
Android	可用	Android Studio 导入 Gradle 工程	进阶玩法，新手可跳过

Windows 下的构建

装好 Visual Studio（勾选 C++ 工作负载）后，用仓库根目录的 CMakePresets.json 生成 Visual Studio 工程，选 Release 配置生成，产物同样在Binaries里。想要一个带桌面快捷方式的标准安装，可以基于 Installer/Installer.nsi 用 NSIS 打安装程序。

macOS 与 Android 点到为止

macOS 上开发者可以用 BuildMacOSUniversalBinary.py 构建同时支持 Intel 和 Apple Silicon 的通用二进制，产物位于universal目录，细节以官方文档为准。Android 需要 Android Studio 环境，导入Source/Android下的 Gradle 工程后由 CMake 自动编译原生代码，这里不展开。

Linux 本地开发模式

不想动系统目录时，加一个开关构建本地开发版，编译后把仓库里的Data/Sys目录软链进Binaries，可执行文件就能带着系统数据直接跑：

cmake -B Build -DLINUX_LOCAL_DEV=true cmake --build Build -j $(nproc) ln -s ../../Data/Sys Build/Binaries/

各发行版依赖包差异较大，缺库报错时按官方文档的依赖清单补齐即可。

按症状修：装好之后最常见的四个坑

主界面能开，一进游戏就报错

原因：模拟器找不到 Sys 目录。Sys 里存放字体和游戏必需的 GameCube 系统数据，从源码安装时它不会自动出现在用户目录里。修复：把仓库的Data/Sys整个拷进你的 Dolphin 用户目录（Linux 默认在~/.local/share/dolphin-emu，Windows 在「文档\Dolphin Emulator」），或直接用上面的本地开发版软链方案。

黑屏、花屏或帧率明显偏低

原因：显卡驱动过旧，或当前视频后端不适合你的硬件。修复：先升级显卡驱动；仍不理想就进设置换后端——Windows 可选 Direct3D 12，macOS 选 Metal，Linux 推荐 Vulkan 或 OpenGL。首次进入 3D 场景时的卡顿多为着色器（提前编译好的图形指令，省去运行时编译开销）现编译，稍等片刻即恢复。