shadPS4 安装教程：5 分钟从零跑通你的 PS4 模拟器

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

shadPS4 是一款用 C++ 编写的 PS4 模拟器，能把 PlayStation 4 的游戏跑在你的 PC 上。它覆盖 Windows、Linux 与 macOS，适合想在电脑上玩 PS4 游戏、又愿意敲几条命令的新手。

快速上手：5 分钟让 PS4 模拟器先跑起来

下面 4 条命令按顺序执行，约 5 分钟就能看到窗口弹出。请先装好编译依赖，各平台清单在下一节。

克隆源码，--recursive 会把所有第三方依赖一并拉下：

git clone --recursive https://gitcode.com/GitHub_Trending/sh/shadPS4
cd shadPS4

配置 CMake，生成 build 目录并指定 Clang 编译器：

cmake -S . -B build/ -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++

并行编译，nproc 会自动用满 CPU 核心：

cmake --build ./build --parallel$(nproc)

直接运行，它会打印全部可用命令：

./build/shadps4

动手前自检：配置达标再开始编译

组件	最低	推荐
系统	Win10 / Linux 5.15+ / macOS 26.0+	Win11 / Linux 6.1+ / Apple Silicon
CPU	支持 AVX2 的 x86-64	8 核以上
内存	8GB	16GB 起
显卡	Vulkan 1.3 兼容	现代独立显卡
磁盘	50GB	100GB SSD

Vulkan（跨平台图形接口）是硬门槛，缺它 shadPS4 无法出图。配置不达标也别硬上：先关掉后台程序、把窗口压到 1280x720 再试。

分平台安装：三步搞定你的系统

Linux

用 Clang 18 最稳。Debian/Ubuntu 装依赖：

sudo apt install build-essential clang git cmake libasound2-dev libopenal-dev libssl-dev vulkan-validationlayers libpng-dev

编译命令同上节；若并行时机器卡死，就去掉 --parallel 参数。

Windows

装 Visual Studio 2022，勾选 “Desktop development with C++” 与 Clang 组件。用 VS 打开含 CMakeLists.txt 的源码文件夹，切到 Clang x64 Release，构建后 shadps4.exe 落在 Build\x64-Clang-Release\。

macOS

需 macOS 26.0 及以上，Intel 机型不支持。先备好 Xcode 与 Homebrew，再编译：

brew install cmake
cmake -S . -B build/ -DCMAKE_OSX_ARCHITECTURES=x86_64
cmake --build build/ --parallel$(sysctl -n hw.ncpu)

首启配置：认全目录，改对 3 个参数

首次运行会在旁边生成 user 文件夹，分好了 log（日志）、sys_modules（系统模块）、data（游戏数据）、cache（缓存）等子目录。游戏本体放进你指定的安装目录，固件模块放进 sys_modules。

user/config.json 里最值得动 3 项：

• internal_screen_width / height：改它，渲染分辨率跟着变，默认 1280x720。
• null_gpu：改成 true 会直接关掉渲染，只剩声音与逻辑，排查性能时有用。
• vkvalidation_enabled：Vulkan 校验开关，能查图形报错，但会拖慢帧率。

手感调优：手柄键鼠映射与提速参数

Xbox 与 DualShock 手柄即插即用。键鼠默认映射：移动 WASD、视角 IJKL、动作键走小键盘数字键；F11 全屏、F10 显示帧率、F12 抓渲染帧。

三个立竿见影的提速项：把窗口压到 1280x720、开启 fsr_enabled（内置超分补清晰度）、保留 rcas_enabled 抗锯齿。低配机器还能把 readbacks_mode 设回 Disabled 省算力。

救火手册：3 类高频故障速查

1. 启动失败 / 直接闪退
   • 现象：命令执行后窗口一闪就没。
   • 可能原因：Vulkan 驱动没装好，或缺 sys_modules 固件模块。
   • 处理：更新显卡驱动；从你自有的 PS4 导出所需 .sprx 模块放进 sys_modules。
2. 黑屏或游戏跑不起来
   • 现象：窗口出来了，画面一片黑。
   • 可能原因：游戏与当前版本不兼容，或文件损坏。
   • 处理：先核对兼容性列表，再确认游戏文件完整；仍不行就开日志看 critical 报错。
3. 音频异常 / 没声音
   • 现象：有画面没声音，或音效错乱。
   • 可能原因：音频后端不匹配，或输出设备选错。
   • 处理：切换 audio_backend（SDL 与 OpenAL 二选一），并确认默认输出设备。

进阶调试：日志、开关与社区入口

日志默认在可执行文件旁的 user/log/shad_log.txt（Linux 在 ~/.local/share/shadPS4/log/），出问题时从文件末尾倒着读 critical 与 error 最快定位。想查渲染就开 renderdoc_enabled，用 F12 抓帧。更多细节见仓库内 documents/building-linux.md 与 documents/Debugging/Debugging.md。

结语

shadPS4 还在快速迭代，今天能跑的游戏明天只会更多。先从《血源》这类已验证的游戏开跑，卡住就翻日志、查社区，祝你玩得开心 🎮

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