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++ 编写、支持 Windows、Linux 和 macOS 的 PlayStation 4 模拟器，让你在电脑上运行真实的 PS4 游戏。本文带你完成最短构建路径、关键配置项和常见问题排查，读完即可运行第一个游戏。

🚀 快速上手：环境要求与最短构建路径

先确认环境满足要求：

本仓库是模拟器核心，不含图形界面；如果你只打算当终端玩家，官方另有带界面的 QtLauncher 可直接下载。以下是核心编译步骤：

1. 克隆仓库（依赖以子模块管理，必须带--recursive）：

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

2. 安装构建依赖（Debian/Ubuntu 示例，其他发行版包名见 Linux 构建文档）：

sudo apt install build-essential clang git cmake libvulkan-dev libopenal-dev

3. 用 Clang 配置并编译，最后直接运行可执行文件：

cmake -S . -B build/ -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ cmake --build ./build --parallel$(nproc) ./build/shadps4

首次运行不带参数时会打印可用命令列表。构建、运行成功后，你能看到的效果类似下面这张游戏内截图：

⚙️ 如何启动游戏并配置 shadPS4

要解决的是：游戏放在哪、怎么启动、改过的设置怎么重置。

1. 在游戏安装目录设置里添加存放游戏文件夹的磁盘位置；启动时直接传游戏 ID（CUSA 编号）即可：

./build/shadps4 CUSA00900

2. 启动参数规则：游戏参数永远放在最后，其他开关写在前面的位置，例如shadPS4 --fullscreen true CUSA00900；想直接启动可执行文件时用完整路径（如/path/to/game.elf），适合文件名不是eboot.bin的情况；--之后的参数会原样透传给游戏本身。
3. 固件模块不能跳过：把从你自己合法持有的 PS4 主机转储的.sprx系统模块（README 中列出的 libSceCesCs、libSceFont、libSceNgs2 等约 30 个）放进配置里的sys_modules目录，否则多数游戏无法正常运行。
4. 重置设置有两种粒度：命令行加--config-clean以出厂默认值启动；配置文件本身位于程序生成的user目录下的config.json，改完保存即可生效。

可以把配置理解成两层开关：全局设置是底层，单游戏覆盖是上层，每个游戏的自定义值会按游戏分别保存，互不影响。

🖥️ shadPS4 图形与性能设置方法

要解决的是：画面分辨率、全屏与帧率表现不理想。以下参数都在 GPU / Vulkan 设置组中（对应config.json字段名）。

1. 分辨率：window_width/window_height控制窗口大小，internal_screen_width/internal_screen_height控制内部渲染分辨率（默认 1280x720）。显存吃紧时先降内部分辨率，比降窗口大小更直接。
2. 全屏与呈现：full_screen设为true并选full_screen_mode（无边框全屏）；present_mode默认Mailbox，一般保持默认即可。
3. 帧率：vblank_frequency默认 60，下限被限制在 30；想验证帧率按F10打开计数器，Ctrl+F10显示视频调试信息。
4. 画质与帧率的取舍：fsr_enabled开启 FSR 放大（低配显存救星）；rcas_enabled默认开启锐化，rcas_attenuation（默认 250）调低可减弱边缘振铃；readbacks_mode三档Disabled / Relaxed / Precise，个别游戏画面缺失时切到 Relaxed 或 Precise 试试，代价是性能下降。

日志也是性能旋钮：把Log.sync设为false可减少同步写日志的开销；日志刷屏时用filter过滤，格式是<类>:<级别>，例如Lib.Pad:Critical只保留致命信息。

🎮 shadPS4 手柄与键鼠设置

要解决的是：没有手柄或想用键盘鼠标玩游戏。

1. Xbox 和 DualShock 手柄开箱即用，无需任何设置；其他手柄可以在输入设置里指定default_controller_id。
2. 键盘默认映射已覆盖全套操作：W/A/S/D左摇杆、I/J/K/L右摇杆、小键盘 8/6/2/4（或 C/B/N/V）对应三角/圆圈/叉/方块、方向键是十字键、回车是 OPTIONS、空格是触摸板、Q/E/U/O对应 L1/L2/R1/R2。
3. 全局快捷键：F11全屏（macOS 用 Command+F11 避开系统快捷键）、F12触发 RenderDoc 抓帧（不可用时退化为游戏内截图）、Alt+F12连 HUD 一起截图。
4. 想改键位时，打开设置菜单里的Controller按钮自定义绑定：每个绑定最多 3 个按键，支持鼠标按键，也能把鼠标移动映射成摇杆输入，且绑定按游戏分别保存，不会串到别的游戏。

🔧 排障与避坑：常见问题排查清单

另外两点：Windows 上 MSYS2/MinGW 构建路径当前是坏的，请用 Visual Studio 2022 或 VSCode + 构建工具方案；提 issue 时按文档要求写清楚游戏名和CUSA-xxxxx编号，别只写"某游戏打不开"。

进阶玩法：着色器转储与渲染调试

1. 把 GPU 设置里的dump_shaders打开，模拟器加载的着色器会转储到user/shader/dumps，配合仓库自带的 着色器补丁文档 可以做patch_shaders修补，适合排查个别游戏的画面问题。
2. 在 Vulkan 设置里打开renderdoc_enabled，或游戏内按 F12 抓帧，检查渲染管线；vkvalidation系列开关（core/sync/gpu）是定位 Vulkan 错误的验证层，正常玩游戏时请关闭，它们会明显拖慢帧率。
3. 纯排查 CPU 侧逻辑时，把null_gpu打开可完全禁掉渲染，省下的开销全部给到模拟核心。

到这里，你手上应该有一个能跑起来的 shadPS4、一套会调的图形与输入参数，以及一份遇到崩溃时知道去哪查的排查清单。建议先挑一款确认能跑的游戏验证环境，再逐步尝试其他作品；任何异常，先看user/log末尾的日志，大部分原因都能在那里定位。

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