shadPS4 PS4 模拟器：从 clone 到第一帧

【免费下载链接】shadPS4PlayStation 4 emulator for Windows, Linux, macOS and FreeBSD written in C++项目地址: https://gitcode.com/GitHub_Trending/sh/shadPS4

shadPS4 是个 PS4 模拟器。它不翻译《血源诅咒》的指令——PS4 的 CPU 就是 x86-64，游戏代码在你的 CPU 上原生跑。

仓库边界：源码核心，不是安装包

shadPS4 这个仓库是模拟器核心，不含图形界面，官方定位是"早期开发阶段"。只想玩游戏的，直接去下载官方 QtLauncher，它有完整的 GUI；要改内核、看代码、提 PR 的，才需要继续往下读。后面所有命令都是命令行操作，适合有 Linux 基础的人。

Linux 下三条命令构建并启动

先在 Ubuntu 24.04 上装构建依赖，编译器用 Clang 23（系统默认 clang 包可能还是 18，需要先从 apt.llvm.org 加源，详见 building-linux.md；GCC 14 被 CI 测试过，但可能撞上未知问题）：

sudo apt install build-essential clang-23 git cmake libasound2-dev libpulse-dev \ libopenal-dev libssl-dev zlib1g-dev libedit-dev libudev-dev libevdev-dev \ libsdl2-dev libjack-dev libsndio-dev libvulkan-dev vulkan-validationlayers libpng-dev

然后克隆、配置、编译、启动，一条链跑完：

git clone --recursive https://gitcode.com/GitHub_Trending/sh/shadPS4 # --recursive 拉子模块，漏了会缺第三方库 cd shadPS4 cmake -S . -B build/ -DCMAKE_C_COMPILER=clang-23 -DCMAKE_CXX_COMPILER=clang++-23 # 指定 Clang 23，和官方 CI 一致 cmake --build ./build --parallel$(nproc) # 编译；卡死就去掉 --parallel 单线程跑 ./build/shadps4 CUSA00900 # 传游戏 ID 直接启动

CUSA00900是《血源诅咒》美版的 ID，前提是user/config.toml里已配好游戏所在目录。Windows 用 Visual Studio 配 CMake，见 building-windows.md；macOS 要 26.0 以上且不支持 Intel，见 building-macos.md。

从 eboot.bin 到原生执行的链接数据流

PS4 的 CPU 和 PC 一样是 x86-64，所以游戏的主循环和渲染调用全是原生代码，没有指令翻译层。真正要做的是伪造一个 Orbis 内核环境，让这段原生代码以为自己跑在 PS4 上。数据流从src/core/loader/elf.cpp开始。

解析与映射：elf.cpp把eboot.bin这个 ELF 的 segment 搬进模拟的 guest 内存（src/core/memory.cpp）。代码此刻已在 PC 内存里，但不能跑——它引用的一堆sceKernel*符号还都是悬空的。

符号解析与重定位：src/core/loader/symbols_resolver.cpp按符号名、所属库和模块匹配，把每个 import 解析成地址。固件.sprx里找得到的走 LLE（直接加载真固件），找不到的退回 HLE，也就是src/core/libraries/里用 C++ 重写的实现。接着src/core/linker.cpp的RelocateAllImports()把导入跳转表填好。

建栈与入口：每个 guest 线程映射到一个 host 线程，src/core/thread.cpp的NativeThread负责这层对应。关键是src/core/libraries/kernel/threads/stack_asm.cpp里的_runOnAnotherStack，一段内联汇编直接改写 host 的RSP寄存器，让 guest 代码在自己的栈上执行。最后linker.cpp的RunMainEntry对齐栈、像真内核那样把EntryParams压到栈顶，然后jmp进游戏入口——从这里起，100% 原生 x86-64。

没有这一层会怎样？PC 上没有 Orbis 内核，游戏那段原生代码会跳进一个没人准备的栈顶、调用不存在的sceKernel*符号，直接崩。linker 干的就是提前把栈、符号、入口参数这三样摆好。

固件、键位与崩溃排查清单

固件文件，第一道坎。模拟器要加载一批来自 PS4 官方固件的.sprx模块，放进sys_modules文件夹。

⚠️libSceCesCs.sprx、libSceFontFt.sprx、libSceJson2.sprx、libSceLibcInternal.sprx、libSceUlt.sprx等必须从你合法持有的 PS4 主机 dump 出来，模拟器本体不带这些文件。

没有手柄？内置映射够玩。WASD 是左摇杆、IJKL 是右摇杆、三角/圆圈/叉/方块对应小键盘 8/6/2/4（也可 C/B/N/V）、方向键即方向键。F11 全屏、F10 帧率、F12 触发 RenderDoc 抓帧。Xbox 和 DualShock 即插即用，自定义绑定按游戏保存。

真崩了？多数是固件没放对，或游戏根本不在兼容列表里。先看 Debugging.md，用 RenderDoc 看一帧里发生了什么；Linux 上用 RenderDoc 要记得设SDL_VIDEODRIVER=x11，Wayland 下它不工作。

官方定位还是"早期开发"，复杂游戏不保证能跑，选作前先去查项目的游戏兼容性列表。想跟进进展就 Star 一下，卡住了带着日志去仓库提 issue。这个 PS4 模拟器每发一版，能玩的游戏就多几款，这是已经成立的趋势。

【免费下载链接】shadPS4PlayStation 4 emulator for Windows, Linux, macOS and FreeBSD written in C++项目地址: https://gitcode.com/GitHub_Trending/sh/shadPS4