shadPS4 安装教程：5 分钟从零到进游戏

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

周末想翻出吃灰的 PS4 光盘，却懒得开主机？其实你只需要一个能在电脑上跑的 shadPS4——这是个用 C++ 写的 PS4 模拟器，本文带你从装环境到跑游戏一次搞定。

① 三句话讲清它是什么

shadPS4 是一款支持 Windows、Linux、macOS 的 PS4 游戏模拟器，能在你的 PC 上直接加载 PS4 游戏并运行。它遵循 GPL-2.0 开源协议，更新很勤快，目前《血源》《只狼》前作《黑暗之魂 重制》《如龙 0》这类游戏都能跑起来。

不过它分两层：这个仓库是"模拟器内核"，本身不带图形界面；如果你只想当玩家用，可以配合官方的 QtLauncher 启动器。咱们这篇文章以"自己编译内核"为主线，装完照样能玩。

② 动手前：10 秒体检清单

装之前先花 10 秒确认你的电脑达标，省得编到一半报错：

项目	✅ 达标	❌ 不达标
CPU	支持 AVX2 的 x86-64 处理器	老古董 CPU 或缺 AVX2
显卡	支持 Vulkan 1.3 的独立显卡	仅核显或太旧的显卡
内存	8GB 起步，16GB 更稳	4GB
磁盘	至少 50GB 空余	快满的机械盘

⚠️ 最容易踩的坑：macOS 用户必须是 Apple Silicon（M 系列芯片）且系统较新，Intel 芯片的 Mac 官方明确不支持，别硬试。

③ 从零到跑起来

不管哪个系统，第一步都是把源码克隆下来，记得带 --recursive 参数，因为项目依赖很多子模块。下面按你所在的系统选一段就行。

Linux 编译步骤

装好 cmake 和 clang 后，克隆、配置、编译一条龙：

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)

这四行干的事：拉代码、进目录、用 clang 配置、开多线程编译。跑完后你应该看到 build/shadps4 这个可执行文件，编译机卡住就删掉最后的 --parallel 参数。

Windows 编译步骤

先装 Visual Studio 2022（选"C++ 桌面开发"，并勾选 Clang 组件）和 Git，然后克隆：

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

接着用 VS2022 打开这个文件夹，把配置切到 Clang x64 Release，对项目 Build 一下。跑完后你应该在 Build\x64-Clang-Release\ 里找到 shadps4.exe。

macOS 编译步骤

Mac 上先装 Homebrew 和构建工具，再克隆配置编译：

brew install cmake ninja
git clone --recursive https://gitcode.com/GitHub_Trending/sh/shadPS4
cd shadPS4
cmake -S . -B build/
cmake --build build/

前一行是装工具，后面是拉代码和编译。跑完后你应该在 build/ 目录里得到可执行的 shadps4，双击或命令行运行都行。

④ 首次启动：三个必改项

第一次运行会在程序旁边生成一个 user 文件夹，里面躺着你的 config.json——所有个性化都改这里。只挑这三个不改就跑不起来的：

• 游戏安装目录（install_dirs） → 填上你存放 PS4 游戏文件夹的路径 → 模拟器靠它定位游戏，不填就找不到要跑啥。
• 系统模块目录（sys_modules_dir） → 指向 sys_modules 文件夹 → 里面要放从你正版 PS4 上导出的 .sprx 固件模块，缺了游戏直接起不来。
• 窗口尺寸（window_width / window_height） → 设成你显示器支持的分辨率 → 避免开局一个拉伸变形的小窗。

改完保存，命令行里 ./build/shadps4 你的CUSA编号 就能启动了。

⑤ 让体验再进一步

性能优化

• 调低渲染分辨率 → 画面降一点，帧数明显上台阶，卡顿时先试这个。
• 关掉同步日志 → 把日志的 sync 设为 false，能省出一些 CPU 开销。
• 释放后台占用 → 关掉浏览器等吃内存的进程，给游戏腾出余量。

控制器与键鼠

手柄玩家有福了：Xbox 和 DualShock 即插即用，不用折腾。没手柄也别慌，内置了完整键鼠映射：

• 移动：WASD，视角：IJKL，动作键：小键盘 2/4/6/8 对应十字/方块/圆圈/三角。
• 全屏：F11；看帧数：F10；截一张游戏内截图：F12。
• 绑定不满意？在设置里点 Controller 按钮，可以逐键重设，而且每个游戏单独保存。

⑥ 卡住了？先翻这三处

别慌，按"症状 → 第一反应 → 兜底方案"对号入座就行：

症状	第一反应	兜底方案
启动直接闪退 / 黑屏	先看日志里有没有 Critical 报错	检查显卡驱动是否支持 Vulkan 1.3
游戏找不到 / 加载失败	确认 install_dirs 路径填对了	检查 sys_modules 固件是否齐全
画面撕裂或帧率低	调低渲染分辨率	关闭无关后台，降低窗口尺寸

日志就一个位置：user/log/shad_log.txt。看不懂报错长啥样时，从上往下翻最后几行最有用。

⑦ 给愿意折腾的你

想深挖的可以开 RenderDoc 抓帧（配置里 renderdoc_enabled 打开后按 F12），逐帧看渲染和着色器；配合日志的 filter 还能只盯某一类消息。更完整的调试与问题上报流程，直接翻 documents/Debugging/Debugging.md 就够用了，这里不展开。

⑧ 相关资源

• 项目入口与游戏运行效果：README.md
• Linux 编译详细文档：documents/building-linux.md
• Windows 编译详细文档：documents/building-windows.md
• macOS 编译详细文档：documents/building-macos.md
• 调试与上报问题指南：documents/Debugging/Debugging.md

跑起来第一局可能会有点慢，那是着色器在缓存，耐心点。装完记得回头看看游戏兼容性列表，挑个稳的先打。祝你上头 🎮

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