企业官网建设流程全解析

KytyPS5命令行参数全解：30+调试与诊断选项助你快速定位PS5模拟问题

【免费下载链接】KytyPS5PlayStation 5 emulator for Windows, Linux and MacOS项目地址: https://gitcode.com/gh_mirrors/ky/KytyPS5

KytyPS5 是一款免费开源的 PlayStation 5 模拟器，支持 Windows、Linux 和 macOS。除了图形化启动器外，它还提供了一组功能完整的KytyPS5 命令行参数，覆盖窗口设置、GPU 选择、Vulkan 校验、着色器日志、性能分析等 30 多项调试与诊断选项。本文带你按场景掌握这些参数，快速定位游戏崩溃、画面错误等 PS5 模拟问题。

快速上手：3 步用对 KytyPS5 命令行参数 🚀

KytyPS5 模拟器主程序为kyty_emulator，基本格式为：

kyty_emulator --game <游戏目录或ELF> [选项]

1. 查看帮助：不带参数运行，或加--help/-h，即可打印全部选项及构建版本信息（实现见 src/main.cpp 中的PrintUsage）。
2. 指定游戏：--game既可以是包含eboot.bin的游戏目录，也可以直接指向 ELF 文件；这是唯一必选参数。
3. 组合诊断选项：按需叠加下文校验、日志、分析类参数。

💡 所有配置项的默认值集中定义在 src/common/emulatorConfig.h 的ConfigOptions中，参数解析逻辑位于 src/main.cpp 的ParseArgs函数。

30+ 参数分类速查表

下表按用途分组，方便按需检索（布尔参数支持true/false、1/0、on/off等写法）。

基础启动参数

窗口与显示参数

GPU 与图形调试参数 🔧

日志、诊断与性能分析参数 📊

输入映射参数

5 组常用诊断组合，快速定位 PS5 模拟问题

以下组合覆盖了最常见的排障场景，直接复制即可使用。

1️⃣ 怀疑图形 API 调用出错（花屏、崩溃）：

kyty_emulator --game "D:\Games\ExampleGame" --vulkan-validation true

若怀疑是着色器越界访问，可加上--gpu-assisted-validation true，但会显著拖慢运行速度。

2️⃣ 捕获某帧画面做离线分析：

kyty_emulator --game "/games/ExampleGame" --rd

启用后在渲染帧处触发 RenderDoc 捕获（实现位于 src/graphics/presentation/renderDoc.cpp），随后可在 RenderDoc 中逐帧检视 GPU 状态。

3️⃣ 排查着色器重编译问题：

kyty_emulator --game "D:\Games\ExampleGame" --shader-log-direction File --shader-log-folder _Shaders --shader-validation true

重编译后的着色器与日志会写入_Shaders目录，代码路径见 src/graphics/shader/recompiler。

4️⃣ 查看游戏内printf调试输出：

kyty_emulator --game "D:\Games\ExampleGame" --printf-direction Console

选择File时输出写入--printf-output-file指定的文件（默认_kyty.txt），适合报告问题附件。

5️⃣ 分析性能瓶颈：

kyty_emulator --game "D:\Games\ExampleGame" --profile

启动 Tracy 分析器后，用 Tracy 客户端连接查看各模块耗时；配合--vblank-frequency可模拟不同刷新率下的表现。

隐藏技巧：环境变量与进阶选项 🔍

除命令行参数外，还有两个环境变量值得关注（见 src/graphics/presentation/window/window.cpp）：

• SDL_VULKAN_LIBRARY：手动指定 Vulkan 加载器路径。macOS 上模拟器会自动查找捆绑的 MoltenVK，一般无需设置；排查驱动问题时可显式指定。
• KYTY_BORDERLESS：macOS 上设置该变量强制创建无边框窗口，用于规避 Rosetta 下的窗口异常。

此外注意：

• 参数写错会立即报错退出（如unknown option、missing value），报错信息本身就是很好的排障线索；
• --gpu-assisted-validation会自动隐含开启--vulkan-validation，无需重复指定；
• 提交 Bug 前建议附上--printf-direction File生成的完整日志与--help输出的构建版本信息，能显著提高问题的可复现性。

相关代码路径

• 参数定义与解析：src/main.cpp
• 默认配置值：src/common/emulatorConfig.h
• 运行入口结构：src/emulator.h
• RenderDoc 捕获接口：src/graphics/presentation/renderDoc.h
• 窗口与 Vulkan 初始化：src/graphics/presentation/window/window.cpp
• 图形渲染后端：src/graphics/host_gpu
• 着色器重编译器：src/graphics/shader/recompiler

掌握这套 30+ 参数的 KytyPS5 命令行工具集后，无论是崩溃、花屏还是性能问题，你都能用最小代价收集到关键的诊断信息，让排查事半功倍。🎮

【免费下载链接】KytyPS5PlayStation 5 emulator for Windows, Linux and MacOS项目地址: https://gitcode.com/gh_mirrors/ky/KytyPS5