如何使用picoCLI递归解析嵌套配置文件并处理选项优先级问题

我将在下文完整解答该问题：这个问题的场景比我之前提问的场景通用性更强，不适合放在原问题下做补充，经过多轮调试、踩坑验证后，我在这里把完整可复用的解决方案分享出来。

适用场景 #

我日常使用picoCLI做多份配置文件的解析工作，这类配置文件支持任意深度的嵌套引入（include）其他配置文件，且部分选项的解析顺序会直接决定最终的生效结果。

在我的业务实现里，有一类格式为section=A:teacher的section选项，作用是指定加载A区段配置，面向教师、学生或其他用户组执行对应处理逻辑（具体业务逻辑此处不展开）。除常规选项外，还定义了configfile=选项，专门用来“引入”其他配置文件。整体配置加载的结构是典型的树形结构，示例如下：

# 命令行直接传入的参数（配置树的根节点）
    section=A:teacher
    configfile=cf-1.txt  # 引入cf-1.txt中的配置
        section=A:student # 缩进代表该选项从cf-1.txt读取
        section=B:principal
        configfile=cf-2.txt  # 读取cf-2.txt中的配置
            section=A:parent # 缩进代表该选项从cf-2.txt读取
            section=C:parent
        section=C:teacher  # 回到cf-1.txt的配置解析
    section=D:admin  # 回到命令行直接传入的参数解析

解析规则要求严格按照深度优先规则遍历这棵配置树，如果同一个区段名对应多个配置项，后解析到的选项直接覆盖先解析的选项：按照这个规则，上面示例里section A最终应该生效parent配置，section C最终应该生效teacher配置。

核心待解决问题 #

问题1：自定义配置文件查找路径 #

解析configfile=选项时，没法直接用picoCLI原生的@语法——因为待引入的配置文件不一定存放在当前工作目录下，我需要自定义一套配置文件查找的路径匹配逻辑，这个问题可以通过下文给出的parseConfigfile方法解决。

问题2：同文件重复选项入参累积破坏覆盖语义 #

picoCLI有一个特殊的设计特性：当同一个文件内重复出现某一个选项时（比如示例里section选项多次出现A、B、C的取值），框架每次命中选项都会调用加了注解的setter方法，但方法接收到的列表入参会累积该选项所有历史传入的值：第一次调用只传入(A:student)，第二次调用传入(A:student,B:prof)，第三次调用传入(A:student,B:prof,C:teacher)，后续调用依此类推。

我从官方公开的问题记录里了解到，这个行为是框架有意设计的，但在我的场景下这会直接导致逻辑错误：section=A:student被重复处理会直接打破“后定义覆盖先定义”的规则，最终导致section A错误生效teacher配置。大部分单值类型的选项不会受这个特性影响，但section=和configfile=这类多值/嵌套类选项会出现解析异常。

内容的提问来源于stack exchange，提问作者LTB