shadPS4 PS4 模拟器入门从源码构建到启动第一款游戏的完整指南【免费下载链接】shadPS4PlayStation 4 emulator for Windows, Linux, macOS and FreeBSD written in C项目地址: https://gitcode.com/GitHub_Trending/sh/shadPS4想在 PC 上运行《血源诅咒》或《如龙 0》shadPS4 是一个用 C 编写的开源 PS4 模拟器目前已经能实机运行多款大作。这份指南带你走完全部流程编译源码、准备固件模块、启动游戏直到出问题时知道该看哪里。一、动手前先搞清楚 shadPS4 是什么你拿到的是内核不是成品README 里有一句关键提醒这个仓库是模拟器核心不带图形界面。如果你只是想当普通玩家官方建议直接下载 QtLauncher 启动器而本文面向的是想亲手构建核心、或想参与开发的人。它现在能跑什么项目自述处于早期开发阶段不要期待完美体验。目前可正常运行的代表作包括《血源诅咒》Bloodborne《黑暗之魂重制版》Dark Souls Remastered《荒野大镖客救赎》Red Dead Redemption《如龙 0》、《DRIVECLUB》、《初音未来歌姬计划 Future Tone》等官方还维护着一份游戏兼容性列表动手前值得先查一下你想玩的游戏是否在内。既然知道了它能做什么下一步先确认你的电脑够不够格。二、环境自检三个平台的硬性要求各系统构建环境对照平台硬性要求编译器/工具链Windowsx86-64ARM64 暂不支持Visual Studio 2022 C Clang Compiler for WindowsMSBuild support for LLVMLinux各主流发行版均可Clang 18为推荐编译器官方构建与 CI 均用它GCC 可能踩坑macOSmacOS 26.0 以上仅限 Apple SiliconXcode 26.0另需 Homebrew 安装cmake等工具⚠️ Intel 芯片的 Mac 直接运行不了源码里会弹窗提示shadPS4 only supports Apple Silicon Macs。显卡与驱动渲染走Vulkan后端src/video_core/renderer_vulkan/请确认 NVIDIA / AMD / Intel 显卡都已装好带 Vulkan 的驱动。Linux 上装libvulkan-dev等依赖包即可见下节命令。环境没问题就可以拉源码了。三、获取源码并构建从零到可执行文件克隆仓库依赖在子模块里项目用 git submodule 管理依赖必须加--recursive否则构建会缺料git clone --recursive https://gitcode.com/GitHub_Trending/sh/shadPS4 cd shadPS4按系统执行构建LinuxDebian/Ubuntu 示例先装依赖再两条命令构建二进制在build/shadps4sudo apt install build-essential clang 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-devcmake -S . -B build/ -DCMAKE_C_COMPILERclang -DCMAKE_CXX_COMPILERclang cmake --build ./build --parallel$(nproc) 如果编译时电脑卡死把--parallel$(nproc)去掉降低并行度。macOS安装 Xcode 与 Homebrew 工具后详见 documents/building-macos.mdcmake -S . -B build/ -DCMAKE_OSX_ARCHITECTURESx86_64 cmake --build build/ --parallel$(sysctl -n hw.ncpu)Windows不用命令行装好 VS2022 后打开本地文件夹选中含CMakeLists.txt的目录把Clang x64 Debug切到Clang x64 Release目标选shadps4.exe然后生成 → 生成全部。产物在Build\x64-Clang-Release\。细节见 documents/building-windows.md。跑一下./build/shadps4不带参数会打印全部命令帮助。构建成功离真正玩游戏只差两样东西固件模块和游戏文件。四、启动第一款游戏准备两样东西① 固件模块放进 sys_modulesshadPS4 需要加载一部分 PS4 固件文件必须放到模拟器的sys_modules文件夹位于程序旁的user/数据目录下首次运行后生成。常用模块包括模块模块libSceFont.sprx / libSceFontFt.sprxlibSceAudiodec.sprxlibSceJpegDec.sprx / libSceJpegEnc.sprxlibScePngEnc.sprxlibSceAvPlayer.sprxlibSceRtc.sprxlibSceNgs2.sprxlibSceJson.sprx⚠️ 这些模块只能从你合法拥有的 PS4 主机中导出缺了游戏跑不起来。② 游戏文件 游戏安装目录把游戏放进任意目录然后用--add-game-folder把它注册为安装目录模拟器就能按游戏 ID 找到它./build/shadps4 --add-game-folder /path/to/your/games常用启动方式速查场景命令按游戏 ID 启动在已注册目录中查找./build/shadps4 CUSA00900全屏启动游戏参数永远放最后./build/shadps4 --fullscreen true CUSA00900直接指定 ELF不叫 eboot.bin 时./build/shadps4 /path/to/game.elf给游戏程序传参./build/shadps4 CUSA00900 -- -flag1 -flag2上表用的是《血源诅咒》美版的 IDCUSA00900。更多参数含义可看 src/main.cpp 或运行--help。画面跑起来后手感是下一个坎——手柄和键盘怎么接、怎么映射下节讲。五、操作配置手柄免驱键盘即插即用手柄插上就玩Xbox 和 DualShock 手柄开箱即用无需任何配置。键盘鼠标默认映射没有手柄也能玩。默认键位源码与 README 一致部分键盘需配合 Fn 键功能默认键左摇杆移动WASD右摇杆视角IJKL△ ○ ✕ □小键盘8624或CBNVOPTIONS 键RETURN触摸板 / 返回SPACEL1 / R1 / L2 / R2Q/U/E/O窗口快捷键F11全屏、F10帧率计数器、F12抓帧后文调试会用。自定义按键设置菜单里点Controller即可改键每个绑定支持最多 3 个按键、鼠标按键甚至把鼠标移动映射成摇杆输入配置按游戏单独保存。手柄和键位都顺了接下来看最容易翻车的部分游戏启动失败或黑屏时怎么办。六、出问题时查哪里日志、配置与抓帧第一步读日志文件日志默认写在可执行文件旁的user/log/shad_log.txt。排查顺序建议从日志尾部往上读——找critical/error级别的报错回看开头确认初始化、内存映射、链接器有无异常若窗口曾画出过画面问题多半在渲染或音频路径值得动的配置项配置在首次运行后生成的user/config.json里常用项详见 documents/Debugging/Debugging.md配置项所在段作用full_screen_modeGPU无边框全屏窗口window_width/window_heightGPU游戏窗口分辨率Log.filterLog按类别过滤日志如Lib.Pad:Criticalrenderdoc_enabledVulkan自动挂接 RenderDocdump_shadersGPU把加载的着色器转储到user/shader/dumps用 RenderDoc 深挖渲染问题装了 RenderDoc 后游戏内按F12即可抓取一帧分析没装则截一张纯游戏画面图AltF12可连 HUD 一起截。Linux 上注意RenderDoc 不支持 Wayland需设SDL_VIDEODRIVERx11运行。到这里从构建到排错的完整链路已经打通。最后给你几条继续深入的路。七、下一步社区、兼容性与贡献查游戏能不能跑官方游戏兼容性列表README 有入口跑通后也建议去那里更新状态提问、交流开发、获取最新动态官方Discord社区想修 bug先读 CONTRIBUTING.md再参考 documents/Debugging/Debugging.md 学会用调试器跟崩溃想了解内核结构从 src/core/系统库与内核和 src/video_core/GPU 模拟两个目录入手换一台机器复用环境documents/building-docker.md 提供 Docker 容器化构建方案下一步行动清单按上表确认显卡 Vulkan 驱动与系统版本装好对应工具链从你的 PS4 导出固件模块放进user/sys_modules用--add-game-folder注册游戏目录挑一款兼容性列表里可运行的游戏启动卡住时先读user/log/shad_log.txt尾部报错再对照第六节排查想参与开发克隆最新代码、跑通一次 Debug 构建并提交 PR结构选择说明本文采用体验叙事架构按了解项目 → 环境自检 → 构建 → 首次启动 → 操作配置 → 排错 → 深入的真实操作时间线推进因为新手卡住的位置恰好沿着这条路径依次出现。【免费下载链接】shadPS4PlayStation 4 emulator for Windows, Linux, macOS and FreeBSD written in C项目地址: https://gitcode.com/GitHub_Trending/sh/shadPS4创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/2 23:29:40 · 阅读 1.2k shadPS4 PS4 模拟器入门：从源码构建到启动第一款游戏的完整指南
shadPS4 PS4 模拟器入门从源码构建到启动第一款游戏的完整指南【免费下载链接】shadPS4PlayStation 4 emulator for Windows, Linux, macOS and FreeBSD written in C项目地址: https://gitcode.com/GitHub_Trending/sh/shadPS4想在 PC 上运行《血源诅咒》或《如龙 0》shadPS4 是一个用 C 编写的开源 PS4 模拟器目前已经能实机运行多款大作。这份指南带你走完全部流程编译源码、准备固件模块、启动游戏直到出问题时知道该看哪里。一、动手前先搞清楚 shadPS4 是什么你拿到的是内核不是成品README 里有一句关键提醒这个仓库是模拟器核心不带图形界面。如果你只是想当普通玩家官方建议直接下载 QtLauncher 启动器而本文面向的是想亲手构建核心、或想参与开发的人。它现在能跑什么项目自述处于早期开发阶段不要期待完美体验。目前可正常运行的代表作包括《血源诅咒》Bloodborne《黑暗之魂重制版》Dark Souls Remastered《荒野大镖客救赎》Red Dead Redemption《如龙 0》、《DRIVECLUB》、《初音未来歌姬计划 Future Tone》等官方还维护着一份游戏兼容性列表动手前值得先查一下你想玩的游戏是否在内。既然知道了它能做什么下一步先确认你的电脑够不够格。二、环境自检三个平台的硬性要求各系统构建环境对照平台硬性要求编译器/工具链Windowsx86-64ARM64 暂不支持Visual Studio 2022 C Clang Compiler for WindowsMSBuild support for LLVMLinux各主流发行版均可Clang 18为推荐编译器官方构建与 CI 均用它GCC 可能踩坑macOSmacOS 26.0 以上仅限 Apple SiliconXcode 26.0另需 Homebrew 安装cmake等工具⚠️ Intel 芯片的 Mac 直接运行不了源码里会弹窗提示shadPS4 only supports Apple Silicon Macs。显卡与驱动渲染走Vulkan后端src/video_core/renderer_vulkan/请确认 NVIDIA / AMD / Intel 显卡都已装好带 Vulkan 的驱动。Linux 上装libvulkan-dev等依赖包即可见下节命令。环境没问题就可以拉源码了。三、获取源码并构建从零到可执行文件克隆仓库依赖在子模块里项目用 git submodule 管理依赖必须加--recursive否则构建会缺料git clone --recursive https://gitcode.com/GitHub_Trending/sh/shadPS4 cd shadPS4按系统执行构建LinuxDebian/Ubuntu 示例先装依赖再两条命令构建二进制在build/shadps4sudo apt install build-essential clang 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-devcmake -S . -B build/ -DCMAKE_C_COMPILERclang -DCMAKE_CXX_COMPILERclang cmake --build ./build --parallel$(nproc) 如果编译时电脑卡死把--parallel$(nproc)去掉降低并行度。macOS安装 Xcode 与 Homebrew 工具后详见 documents/building-macos.mdcmake -S . -B build/ -DCMAKE_OSX_ARCHITECTURESx86_64 cmake --build build/ --parallel$(sysctl -n hw.ncpu)Windows不用命令行装好 VS2022 后打开本地文件夹选中含CMakeLists.txt的目录把Clang x64 Debug切到Clang x64 Release目标选shadps4.exe然后生成 → 生成全部。产物在Build\x64-Clang-Release\。细节见 documents/building-windows.md。跑一下./build/shadps4不带参数会打印全部命令帮助。构建成功离真正玩游戏只差两样东西固件模块和游戏文件。四、启动第一款游戏准备两样东西① 固件模块放进 sys_modulesshadPS4 需要加载一部分 PS4 固件文件必须放到模拟器的sys_modules文件夹位于程序旁的user/数据目录下首次运行后生成。常用模块包括模块模块libSceFont.sprx / libSceFontFt.sprxlibSceAudiodec.sprxlibSceJpegDec.sprx / libSceJpegEnc.sprxlibScePngEnc.sprxlibSceAvPlayer.sprxlibSceRtc.sprxlibSceNgs2.sprxlibSceJson.sprx⚠️ 这些模块只能从你合法拥有的 PS4 主机中导出缺了游戏跑不起来。② 游戏文件 游戏安装目录把游戏放进任意目录然后用--add-game-folder把它注册为安装目录模拟器就能按游戏 ID 找到它./build/shadps4 --add-game-folder /path/to/your/games常用启动方式速查场景命令按游戏 ID 启动在已注册目录中查找./build/shadps4 CUSA00900全屏启动游戏参数永远放最后./build/shadps4 --fullscreen true CUSA00900直接指定 ELF不叫 eboot.bin 时./build/shadps4 /path/to/game.elf给游戏程序传参./build/shadps4 CUSA00900 -- -flag1 -flag2上表用的是《血源诅咒》美版的 IDCUSA00900。更多参数含义可看 src/main.cpp 或运行--help。画面跑起来后手感是下一个坎——手柄和键盘怎么接、怎么映射下节讲。五、操作配置手柄免驱键盘即插即用手柄插上就玩Xbox 和 DualShock 手柄开箱即用无需任何配置。键盘鼠标默认映射没有手柄也能玩。默认键位源码与 README 一致部分键盘需配合 Fn 键功能默认键左摇杆移动WASD右摇杆视角IJKL△ ○ ✕ □小键盘8624或CBNVOPTIONS 键RETURN触摸板 / 返回SPACEL1 / R1 / L2 / R2Q/U/E/O窗口快捷键F11全屏、F10帧率计数器、F12抓帧后文调试会用。自定义按键设置菜单里点Controller即可改键每个绑定支持最多 3 个按键、鼠标按键甚至把鼠标移动映射成摇杆输入配置按游戏单独保存。手柄和键位都顺了接下来看最容易翻车的部分游戏启动失败或黑屏时怎么办。六、出问题时查哪里日志、配置与抓帧第一步读日志文件日志默认写在可执行文件旁的user/log/shad_log.txt。排查顺序建议从日志尾部往上读——找critical/error级别的报错回看开头确认初始化、内存映射、链接器有无异常若窗口曾画出过画面问题多半在渲染或音频路径值得动的配置项配置在首次运行后生成的user/config.json里常用项详见 documents/Debugging/Debugging.md配置项所在段作用full_screen_modeGPU无边框全屏窗口window_width/window_heightGPU游戏窗口分辨率Log.filterLog按类别过滤日志如Lib.Pad:Criticalrenderdoc_enabledVulkan自动挂接 RenderDocdump_shadersGPU把加载的着色器转储到user/shader/dumps用 RenderDoc 深挖渲染问题装了 RenderDoc 后游戏内按F12即可抓取一帧分析没装则截一张纯游戏画面图AltF12可连 HUD 一起截。Linux 上注意RenderDoc 不支持 Wayland需设SDL_VIDEODRIVERx11运行。到这里从构建到排错的完整链路已经打通。最后给你几条继续深入的路。七、下一步社区、兼容性与贡献查游戏能不能跑官方游戏兼容性列表README 有入口跑通后也建议去那里更新状态提问、交流开发、获取最新动态官方Discord社区想修 bug先读 CONTRIBUTING.md再参考 documents/Debugging/Debugging.md 学会用调试器跟崩溃想了解内核结构从 src/core/系统库与内核和 src/video_core/GPU 模拟两个目录入手换一台机器复用环境documents/building-docker.md 提供 Docker 容器化构建方案下一步行动清单按上表确认显卡 Vulkan 驱动与系统版本装好对应工具链从你的 PS4 导出固件模块放进user/sys_modules用--add-game-folder注册游戏目录挑一款兼容性列表里可运行的游戏启动卡住时先读user/log/shad_log.txt尾部报错再对照第六节排查想参与开发克隆最新代码、跑通一次 Debug 构建并提交 PR结构选择说明本文采用体验叙事架构按了解项目 → 环境自检 → 构建 → 首次启动 → 操作配置 → 排错 → 深入的真实操作时间线推进因为新手卡住的位置恰好沿着这条路径依次出现。【免费下载链接】shadPS4PlayStation 4 emulator for Windows, Linux, macOS and FreeBSD written in C项目地址: https://gitcode.com/GitHub_Trending/sh/shadPS4创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考