rpcs3 PS3 模拟器贡献指南：三步走完你的第一个 PR

rpcs3 PS3 模拟器贡献指南：三步走完你的第一个 PR

【免费下载链接】rpcs3PlayStation 3 emulator and debugger项目地址: https://gitcode.com/GitHub_Trending/rp/rpcs3

rpcs3 是一款免费开源的 PlayStation 3 模拟器与调试器。这篇 rpcs3 贡献指南带你按三个阶段推进：先提一个高质量 Issue，再走通一次完整 PR，最后挑一个模块深入，全程无需 C++ 功底。

十分钟提一个维护者愿意回复的 Issue

Issue 质量决定它的生命周期，含糊的报告几乎必然被淹没。项目明确欢迎不写代码的人测游戏、报 bug，这是门槛最低的入口。

1. 先搜一遍已有 Issue。重复的话去原帖补充信息，而不是新开一个。
2. 三步复现：写清模拟器版本号、你的系统与显卡、触发问题的游戏或操作。
3. 贴上日志。每次运行都会在bin/Logs目录生成日志，直接附上，按"现象 + 期望行为 + 复现步骤 + 日志"的顺序写完整。

Issue 挂几天没人理很正常，追评一句"仍有问题"即可；维护者要处理大量工单，给点耐心。

走通第一个 PR：克隆、编译、本地验证

不在自己机器上跑通的 PR 过不了评审，本地编译模拟器是绕不开的一环。依赖偏重（CMake 3.28+、Qt 6.11、Vulkan SDK），Linux 下照 BUILDING.md 一次配齐即可。

🚀 克隆仓库并初始化子模块（第三方依赖都藏在这里）：

git clone --recurse-submodules https://gitcode.com/GitHub_Trending/rp/rpcs3 cd rpcs3

编译（Linux）：

cmake -B build -G Ninja cmake --build build

Windows 用户用 Visual Studio 2022 打开rpcs3.sln，选 Release 构建。完成后直接运行：

./build/bin/rpcs3

✅ 主界面弹出来、不闪退，环境就算通了。接下来创建fix/xxx这样的分支，做最小范围的改动，commit 信息以模块名开头（如RSX:、Cell:）。PR 描述里写清改了什么、怎么验证的；若借助过 AI，明确说明哪部分由 AI 参与——项目要求披露这一点。

CI 红了就先等结果再回评审意见；一个 PR 只放一个主题，避免堆叠提交把 diff 搅乱。

挑一个想深入的模块：目录地图

乱挑方向只会白费功夫，先摸清目录和功能的对应关系：

• rpcs3/tests/：单元测试，test_fmt.cpp这类文件短小，是修断言、补覆盖的首选第一目标
• rpcs3/Emu/：CPU、图形与内存模拟核心，Cell、RSX、Memory 子目录各对应一类模拟对象
• rpcs3/rpcs3qt/：Qt 界面，设置对话框和游戏列表在这里，改动肉眼可见、好验证
• rpcs3/Loader/：ISO、PKG 等游戏镜像的加载逻辑

建议先在测试和界面里修小而完整的 bug，用两三个 PR 熟悉评审节奏，再进 Emu。把 CMakePresets.json 里的 Debug 预设切出来，配合内置调试器单步读代码，比干读源码快得多。

现在打开 BUILDING.md，把仓库克隆到本地，完成你的第一次构建。

【免费下载链接】rpcs3PlayStation 3 emulator and debugger项目地址: https://gitcode.com/GitHub_Trending/rp/rpcs3