RetroArch 命令行如何用 --subsystem 加载多卡内容？-育师

RetroArch 命令行如何用 --subsystem 加载多卡内容？

【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch

用 RetroArch 的命令行方式加载 libretro core 时，最常见的组合是--libretro指定 core、后面跟一个 ROM 文件。但有些内容需要同时加载多张卡（多个 content 文件），且各卡之间有固定的加载顺序——这时单文件加载方式就不够了。RetroArch 命令行提供--subsystem SUBSYSTEM选项来处理这种情况：它声明要使用已加载 libretro core 的某个子系统，并把多个 content 文件作为多个命令行参数传入。

本文基于仓库中的 man page 文档 docs/retroarch.6 整理，说明该选项的用法、参数顺序规则、以及如何用 verbose 日志核对内容加载顺序。

`--subsystem`的四个文档要点

docs/retroarch.6 中对--subsystem SUBSYSTEM的定义是：

Use a subsystem of the loaded libretro core. Multiple content files are loaded as multiple arguments. If content is skipped, use a blank ("") command line argument. Content must be loaded in an order which depends on the particular subsystem used. See verbose log output to learn how a particular subsystem wants content to be loaded.

翻译成可操作的规则，就是四条：

该选项使用的是已加载 libretro core 内部的子系统，因此必须先通过-L/--libretro指定 core；
多张卡以多个命令行参数的形式跟在命令后面传入；
如果某个槽位没有对应的卡，要传一个空字符串""作为占位参数，不能直接少传；
content 必须按该子系统要求的顺序加载；顺序不确定时，用 verbose 日志输出查看该子系统期望的加载顺序。

组装命令

命令行的基本骨架来自 man page 的命令行示例：

retroarch --config ~/.config/retroarch/retroarch.cfg --libretro /path/to/libretro/core.so /path/to/rom.rom --verbose

在加载多卡内容时，在同一个骨架上加入--subsystem并追加多个 content 参数。下面代码块中的/path/to/...和SUBSYSTEM是占位符，需替换为你自己的 core 路径、content 路径以及 core 定义的子系统名称：

retroarch \ --config ~/.config/retroarch/retroarch.cfg \ --libretro /path/to/libretro/core.so \ --subsystem SUBSYSTEM \ /path/to/content1 /path/to/content2 /path/to/content3 \ --verbose

各部分的文档依据与适用条件：

--libretro PATH（短选项-L）：指定要使用的 libretro 实现路径。该选项会覆盖配置文件中的任何相关设置；只有当 RetroArch 编译时启用了 dynamic libretro loading 才可用。
--subsystem SUBSYSTEM：声明使用 core 中的哪个子系统，多卡加载必须依赖它。
多个 content 文件：作为并列的命令行参数传入；缺某个槽位时传""（一对引号内的空字符串）。
--verbose（短选项-v）：开启 verbose 日志，用来核对子系统期望的 content 顺序，见下节。
--config PATH（短选项-c）：可选。不传时 RetroArch 会按平台路径查找配置文件（例如 Unix-like 系统依次查找$XDG_CONFIG_HOME/retroarch/retroarch.cfg、$HOME/.retroarch.cfg）。

man page 的[rom file(s)]条目同时说明：content 类型是否受支持取决于所用 libretro 实现的定义；RetroArch 使用未压缩的 content，若编译时启用了相应支持，也可以解压 .zip/deflate 格式的 content。

用 verbose 日志核对加载顺序

多卡内容失败最常见的原因是 content 顺序与子系统要求不符。文档给出的核对方法只有一个：加--verbose运行，查看日志输出。

See verbose log output to learn how a particular subsystem wants content to be loaded.

也就是说，文档把“确认子系统期望的加载顺序”这件事交给 verbose 日志本身：先带--verbose启动，从日志中读出该子系统要求的 content 排列，再按这个顺序重排命令行参数。man page 没有提供独立列出子系统名称或其内容布局的命令，因此子系统名称与顺序都以 core 定义和日志输出为准。

限制与边界

-L/--libretro仅在 RetroArch 以 dynamic libretro loading 方式编译时可用；命令行没有-L时，--subsystem失去依附的 core，无法完成多卡加载。
content 的加载顺序是子系统相关的，不同子系统之间不通用；换子系统就要按日志重新确认顺序。
content 类型支持范围由 libretro 实现决定，RetroArch 本身不额外扩展支持格式。
命令行不带任何 rom 参数时，RetroArch 会尝试加载不带 rom 的 core，且“这只会对部分 libretro core 有效”——这是[rom file]条目对普通加载路径的说明，与--subsystem的多参数路径不同，不要混用两种加载方式。