shadPS4 从零到跑通第一个游戏：新手完整的 PS4 模拟器上手指南

shadPS4 从零到跑通第一个游戏：新手完整的 PS4 模拟器上手指南

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

shadPS4 是一个用 C++ 编写的 PlayStation 4 模拟器，支持 Windows、Linux 和 macOS，目前已经能跑动《血源》《如龙 0》《DriveClub》等真实 PS4 游戏。无论你是想尝鲜的萌新，还是折腾多年的模拟器老玩家，跟着这份指南，5 分钟就能从拿到源码到把游戏跑起来。

先搞清楚：它能干什么，你该拿哪个

shadPS4 的定位很直接：在你的 PC 上加载 PS4 游戏，用 Vulkan（一套现代图形接口，你装好显卡驱动就自动有了）重绘画面、用原生 x86-64 指令直接执行游戏代码，所以性能上限比传统"逐条翻译指令"的模拟器高。

这里有个新手最容易踩的坑：本仓库是模拟器内核，不带图形界面。如果你只想玩，不想碰命令行，官方建议直接用配套的 QtLauncher（一个带图形界面的启动器，去官方渠道下载即可），它内部用的就是这份内核。本文教你把内核本身编译并跑起来——理解了它，玩 QtLauncher 时你才看得懂那些设置项。

它现在能稳定运行的游戏包括《血源》《黑暗之魂 重制版》《荒野大镖客》等，更多情况可以去官方兼容性列表查一下你的目标游戏。

三步拿到可执行文件：系统要求与编译

先对一下硬件门槛，不达标就别往下看了：

macOS 注意两点：只支持 Apple Silicon 芯片的 Mac，Intel Mac 直接放弃。

Linux 编译只需三条命令

以 Debian/Ubuntu 为例（先按 documents/building-linux.md 装好 clang、vulkan、openal 等依赖，Fedora/Arch 的依赖包名文档里都给了）。Clang 是官方推荐编译器，用 GCC 编译出的东西报问题时官方不一定接招。

git clone --recursive https://gitcode.com/GitHub_Trending/sh/shadPS4 cd shadPS4 && cmake -S . -B build/ -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ cmake --build ./build --parallel$(nproc)

--recursive不能省，项目的第三方依赖全挂在子模块里。如果编译时电脑卡死，去掉最后的--parallel参数重试。Windows 用户走 documents/building-windows.md，用 Visual Studio 打开 CMake 项目选 x64-Release 构建即可。

最小闭环：把一款游戏启动起来

编译完拿到build/shadps4，别急着高兴，还差两样东西：

1. 固件模块：把 PS4 的sys_modules文件夹（含libSceAvPlayer.sprx、libSceFont.sprx等几十个 .sprx 文件，需从你自己合法拥有的 PS4 主机上导出）放到模拟器的用户目录下，并在配置里指过去。缺了它游戏基本起不来。
2. 游戏文件：把游戏安装到本地某个目录（通常按CUSAxxxxx产品编号命名文件夹），然后在配置里注册为游戏安装目录。

之后就是最爽的一行命令：

./build/shadps4 CUSA00900 --fullscreen true

CUSA00900就是《血源》美版的产品编号，模拟器会去你注册的安装目录里找它并直接启动。也可以直接喂一个 ELF 文件路径给它，方便启动非标准入口点的可执行文件；加--help能看全部参数。

把帧率和画面拉起来的 4 个开关

配置文件是用户目录下的config.toml，首次运行会自动生成。不用逐行读，只认这几个关键参数：

另外full_screen和window_width/window_height控制窗口形态。项目对每个参数都有默认值，只改你不满意的，别整段覆盖。

手柄键位、黑屏排查与调试入口

输入方面零配置：Xbox 和 DualShock 手柄即插即用。没手柄时键盘有完整默认映射——WASD 走路、IJKL 转视角、Numpad 8/6/2/4 对应 △○✕□、回车是 OPTIONS。按键冲突可以在设置界面按游戏单独改，每个绑定最多支持三个键。

跑起来之后几个救命快捷键：

如果黑屏或闪退，先查这三处：日志文件（用户目录下 log 文件夹里的shad_log.txt，报错信息都在里面）、sys_modules是否放全、显卡驱动是否支持 Vulkan 1.3。更系统的调试流程和反馈问题的规范，见 documents/Debugging/Debugging.md；想深入着色器重编译这块的，可以翻 documents/patching-shader.md。

shadPS4 还在快速迭代，今天跑不动的游戏下周可能就通了，关注项目更新就好。遇到具体卡点先看上面提到的调试文档，祝你在 PC 上重温爱玩的 PS4 游戏 🎮

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