如果每次调整输出目录、批处理数量或显示颜色，都要在源码中搜索和修改，程序很容易出现遗漏。配置文件能把这些变化集中到一个位置，也方便比较两次运行之间的差异。

YAML 适合表示层次清楚的参数，但它只负责记录数据，不会自动保证参数合理。

按用途组织字段

下面是一份用于讲解的配置。字段按输入、处理和输出分组，单位写在名称或注释里：

input:
  directory: "example-data"
processing:
  batch_size: 20
  timeout_seconds: 5
output:
  directory: "example-results"
  overwrite: false

缩进使用空格，并在整个文件中保持一致。看起来像日期、版本号或带前导零的编号，最好用引号明确写成字符串。不同解析器和 YAML 版本的隐式类型规则可能不同，关键字段仍要由程序校验。

配置的文字说明也应解释路径相对于哪里。例如，可以约定相对路径以配置文件所在目录为基准。这个约定需要在加载代码中落实，不能只依赖启动程序时碰巧处于正确目录。

加载以后先检查

解析成功，只能说明文件符合解析器接受的语法。批处理数量是负数、目录字段是列表，这些内容仍可能是合法 YAML。

程序可以在开始工作前检查字段的存在、类型和取值范围。下面展示加载后的部分校验，假定 config 已经由数据型安全加载接口读取：

processing = config.get("processing", {})
batch_size = processing.get("batch_size", 20)
if type(batch_size) is not int or batch_size <= 0:
    raise ValueError("processing.batch_size must be a positive integer")

这里显式排除了布尔值被当成整数的情况。真实程序还需要先检查顶层和分组是否为映射，并根据使用场景检查目录权限。读取不可信文件时，也应避免使用能构造任意程序对象的加载模式。

默认值与覆盖顺序要明确

配置来源可能包括程序默认值、文件和命令行参数。对简单程序，可以固定为“默认值 → 配置文件 → 命令行”，后面的值覆盖前面的值，并在帮助文档中说明。

还要区分缺失字段与主动填写的空值。用户没有填写超时值，可能意味着使用默认值；填写空值，是否表示禁用超时，则必须由程序明确规定。不要靠一个模糊的真假判断把两者混在一起。

保存最终生效的配置

排查结果差异时，最有用的往往是实际生效的参数，而不只是原始配置文件。程序可以在输出目录保存一份脱敏后的配置快照，连同程序版本和运行状态一起记录。

令牌、密码等秘密应由受保护的渠道提供，也不应进入普通日志或版本库。配置文件的目标是让变化更容易管理；让字段含义和加载规则保持清楚，才是这份便利能够持续的前提。