Sudachi在安卓和 Linux 上跑起 Switch 游戏的最快上手路径【免费下载链接】sudachiSudachi is a Nintendo Switch emulator for Android, Linux, macOS and Windows, written in C项目地址: https://gitcode.com/GitHub_Trending/suda/sudachiSudachi 是一个用 C 编写的开源 Nintendo Switch 模拟器官方支持 Android、Linux 和 Windows构建配置里也包含 macOS。这篇文章带你走通 Android 与 Linux 两条最短的编译路径把图形、音频、联机这几个大模块讲清楚再附一张常见问题速查表。适合想把 Switch 游戏跑在手机上或 PC 上、并且想知道怎么装、哪里改、坏在哪的你。从克隆到出包两条最短路径Sudachi 以源码方式分发各平台成品可从项目 Releases 页获取。自己编译前仓库必须带子模块克隆漏掉--recursive时 CMake 会直接报错git clone --recursive https://gitcode.com/GitHub_Trending/suda/sudachi路径一Androiddocumentation/building/ANDROID.md 列出的环境要求是 Git、JDK、Vulkan SDK文档指定使用 1.3.280.0Windows 用户另需 Visual Studio 17.9.6 并勾选 C 桌面开发工作负载Android Studio 版本为 Iguana。环境就绪后进入src/android目录Windows 执行gradlew.bat build其余系统执行gradlew build产物是可直接安装到手机的 APK。构建过程还会自动下载 Vulkan 验证层VVL 1.3.261.1 的 arm64 二进制放进 jniLibs调试图形问题时开箱可用。路径二Linux按 documentation/building/LINUX.md 安装依赖文档给出一整条 apt 命令覆盖 cmake、Qt5、SDL2、FFmpeg 编解码库等mkdir build; cd build执行文档中的 cmake 命令关键参数含-DSUDACHI_USE_BUNDLED_VCPKGON -DCMAKE_BUILD_TYPERelease -GNinjacmake --build . --config Release要求 CMake 3.22 以上不指定构建类型时默认就是 Release。装好后你拿到哪些功能图形Vulkan 为主OpenGL 可开图形逻辑集中在 src/video_core/。Vulkan 后端是主力Vulkan-Headers 与 Vulkan-Utility-Libraries 默认就打包在 externals 里对应 CMake 的SUDACHI_USE_EXTERNAL_VULKAN_HEADERS等选项ENABLE_OPENGL默认 ON但被标记为高级选项日常构建界面里不太显眼。超采样侧接入了 FSR外部库在 externals/FidelityFX-FSR对应实现是 video_core/fsr.cpp 和 fsr.h。着色器转译由 src/shader_recompiler/ 完成内部按 frontend、backend、ir_opt 三个阶段组织shader_cache.cpp 提供缓存同一着色器第二次使用不用重新编译。音频与输入后端可换模块分层音频核心在 src/audio_core/ 下分两层renderer 目录负责渲染管线下面还有 effect、voice、mix、splitter 等子模块输出端在 sink/ 目录按平台选后端——cubeb 默认 ONAndroid 可用 oboe另有 sdl2 与 null 两个实现ENABLE_CUBEB开关默认开启。输入由 input_common/引擎、轮询、按键映射和 hid_core/ 负责后者含 hidbus 控制器总线与 irsensor 红外传感器两个子模块。联机房宿主机和服务端都在同一棵源码树非 Android 构建时SUDACHI_ROOM默认 ON会编译 src/dedicated_room/ 里的专用房间服务LDN room server配合 src/network/ 的 room、room_member 等模块提供联机房间ENABLE_WEB_SERVICE也默认开启src/web_service/ 承载遥测、用户校验等接口。Discord 在线状态USE_DISCORD_PRESENCE默认关闭想要就自己在 cmake 参数里打开。三个真实会碰到的场景从 PC 换到手机上玩代码库可以复用但两条构建链完全独立Linux 走 CMakeAndroid 走 Gradle依赖也不通用Qt5/SDL2 与 Android Studio/JDK。所以在src/android下重新执行 gradlew build 即可之前 Linux 的 build 目录不用管。PC 性能吃紧时先抄这份参数Linux 文档的 cmake 命令里就藏着几个调优项可直接照抄编译器走 ccache 路径/usr/lib/ccache/g 与 gcc、-DSUDACHI_ENABLE_LTOON打开链接期优化默认 OFF、-DCMAKE_CXX_FLAGS-marchx86-64-v2让编译器发出更新的指令集。想要免安装的绿色版保留SUDACHI_ENABLE_PORTABLE默认 ON它会在当前目录发现用户文件夹时启用便携模式。和朋友在本机联机在非 Android 平台按默认参数编译SUDACHI_ROOMON会带出房间服务端放在一台 PC 上运行其他玩家以客户端接入Android 侧该选项默认 OFF手机只当客户端房宿主机留在电脑上。卡住了先看这张表现象先查这里再试这个CMake 报 Git submodule ... not found克隆时是否带--recursive执行git submodule update --init --recursive后重跑 cmakeAndroid 上图形异常Vulkan SDK 是否按文档装好指定 1.3.280.0保持SUDACHI_DOWNLOAD_ANDROID_VVL开启默认 ON构建时会自动下载验证层找不到游戏兼容列表README 明确写着 Compatibility is currently unavailable关注 Releases 页的新版本想提交 bug 修复README 声明不接受贡献PR 会被关闭去提 issue 反馈别建 PRLinux 编译报大量缺库错误是否完整执行过 LINUX.md 的依赖安装把文档里的 apt 列表整段粘到终端装一遍再重新 cmake下一步做什么先把上面的路径一或路径二跑通一个拿到能启动的包再对照 documentation/building/ 里的两份文档核对自己的环境版本。遇到文档没覆盖的问题去项目的 issue 区反馈——这个项目目前不收 PRissue 是唯一有效的反馈渠道。【免费下载链接】sudachiSudachi is a Nintendo Switch emulator for Android, Linux, macOS and Windows, written in C项目地址: https://gitcode.com/GitHub_Trending/suda/sudachi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考