目录一、什么是配置文件？二、为什么需要配置文件？1. 配置和代码分离2. 不同项目使用不同配置项目 A项目 B3. 方便自动化三、YAML 是什么？四、YAML 基础语法4.1 Key-Value4.2 层级结构五、YAML 中的数组六、YAML 的注释七、JSON 是什么？八、JSON 基础语法九、同一个配置，用 YAML 和 JSON 怎么写？十、YAML 和 JSON 的主要区别十一、ECU 测试工具中的 YAML 配置十二、工具配置十三、Agent 配置十四、JSON 更适合什么？十五、配置文件和 Tool Calling 的区别十六、配置文件的一个重要设计原则十七、YAML + JSON 的组合使用十八、配置文件设计时要注意什么？1. 命名清晰2. 层级合理3. 不要把业务逻辑塞进配置4. 做好默认值十九、YAML、JSON、Markdown 如何配合？MarkdownYAMLJSON二十、总结在软件开发、自动化测试和 AI Agent 开发过程中，我们经常会看到两个非常常见的文件格式：YAML 和 JSON。很多初学者第一次接触它们时，会觉得：“这不就是把参数写到一个文件里吗？”其实没错。它们最常见的用途之一，就是配置。例如一个 ECU 测试工具需要知道：使用哪个 CAN 通道？CAN 波特率是多少？Vector 工具安装在哪里？使用哪个 ECU？日志保存在哪里？Agent 使用什么模型？Tool 有哪些参数？是否开启自动报告？这些信息通常不应该直接写死在程序代码中，而应该放到独立的配置文件里。YAML 和 JSON，就是实现这种“配置与程序逻辑分离”的常见方式。本文不讨论测试用例设计，而是专门介绍：YAML 和 JSON 是什么，以及如何使用它们进行工程配置。一、什么是配置文件？先来看一个简单的问题。假设我们开发一个 CAN 测试程序。程序需要知道：CAN通道 = CAN1 波特率 = 500000 日志目录 = ./logs 超时时间 = 5000ms如果直接写在 Python 程序里面：channel="CAN1"baudrate=500000log_path="./logs"timeout=5000那么换一个项目就需要修改代码。例如项目 B 使用：CAN2 250000 D:/ECU_Project/logs 10000ms又需要修改程序。这显然不够灵活。更好的方式是把这些参数放到配置文件中：config.yaml程序启动时读取配置：配置文件 ↓ 程序读取 ↓ 初始化测试环境 ↓ 开始运行这样：程序负责“怎么做”，配置文件负责“使用什么参数”。这就是配置文件最核心的思想。二、为什么需要配置文件？配置文件主要解决三个问题。1. 配置和代码分离代码负责逻辑：连接CAN 初始化工具 执行操作 记录日志配置文件负责参数：CAN1 500000 日志目录 超时时间这样修改参数的时候，不需要修改程序。2. 不同项目使用不同配置例如：项目 ACAN1 500000 ECU_A项目 BCAN2 250000 ECU_B程序完全可以保持不变。只需要替换：config_A.yaml config_B.yaml3. 方便自动化对于 AI Agent、CI/CD 和自动化测试系统来说，配置文件非常重要。例如：Agent ↓ 读取配置 ↓ 初始化工具 ↓ 连接ECU ↓ 执行任务整个过程可以不需要人工修改代码。三、YAML 是什么？YAML 是一种非常适合人阅读和编辑的数据格式。它的特点是：语法简单层级清晰支持注释适合配置人类可读性好例如一个 ECU 环境配置：ecu:name:BCMprotocol:CANchannel:CAN1baudrate:500000logging:enabled:truepath:./logs基本不需要额外解释，就能看懂。四、YAML 基础语法4.1 Key-Value最基本的 YAML：name:ECU_Testversion:1.0enabled:true可以理解为：name → ECU_Test version → 1.0 enabled → true4.2 层级结构YAML 最重要的特点之一就是使用缩进表示层级。例如：ecu:name:BCMprotocol:CANchannel:CAN1baudrate:500000结构相当于：ecu ├── name ├── protocol ├── channel └── baudrate因此 YAML 对缩进比较敏感。工程实践中建议统一使用 2 个空格或者 4 个空格。五、YAML 中的数组YAML 使用-表示数组。例如：supported_protocols:-CAN-LIN-Ethernet也可以配置多个工具：tools:-name:CANoe YAML 与 JSON 配置文件详解：从基础语法到 AI Agent 与 ECU 测试工具配置
目录一、什么是配置文件？二、为什么需要配置文件？1. 配置和代码分离2. 不同项目使用不同配置项目 A项目 B3. 方便自动化三、YAML 是什么？四、YAML 基础语法4.1 Key-Value4.2 层级结构五、YAML 中的数组六、YAML 的注释七、JSON 是什么？八、JSON 基础语法九、同一个配置，用 YAML 和 JSON 怎么写？十、YAML 和 JSON 的主要区别十一、ECU 测试工具中的 YAML 配置十二、工具配置十三、Agent 配置十四、JSON 更适合什么？十五、配置文件和 Tool Calling 的区别十六、配置文件的一个重要设计原则十七、YAML + JSON 的组合使用十八、配置文件设计时要注意什么？1. 命名清晰2. 层级合理3. 不要把业务逻辑塞进配置4. 做好默认值十九、YAML、JSON、Markdown 如何配合？MarkdownYAMLJSON二十、总结在软件开发、自动化测试和 AI Agent 开发过程中，我们经常会看到两个非常常见的文件格式：YAML 和 JSON。很多初学者第一次接触它们时，会觉得：“这不就是把参数写到一个文件里吗？”其实没错。它们最常见的用途之一，就是配置。例如一个 ECU 测试工具需要知道：使用哪个 CAN 通道？CAN 波特率是多少？Vector 工具安装在哪里？使用哪个 ECU？日志保存在哪里？Agent 使用什么模型？Tool 有哪些参数？是否开启自动报告？这些信息通常不应该直接写死在程序代码中，而应该放到独立的配置文件里。YAML 和 JSON，就是实现这种“配置与程序逻辑分离”的常见方式。本文不讨论测试用例设计，而是专门介绍：YAML 和 JSON 是什么，以及如何使用它们进行工程配置。一、什么是配置文件？先来看一个简单的问题。假设我们开发一个 CAN 测试程序。程序需要知道：CAN通道 = CAN1 波特率 = 500000 日志目录 = ./logs 超时时间 = 5000ms如果直接写在 Python 程序里面：channel="CAN1"baudrate=500000log_path="./logs"timeout=5000那么换一个项目就需要修改代码。例如项目 B 使用：CAN2 250000 D:/ECU_Project/logs 10000ms又需要修改程序。这显然不够灵活。更好的方式是把这些参数放到配置文件中：config.yaml程序启动时读取配置：配置文件 ↓ 程序读取 ↓ 初始化测试环境 ↓ 开始运行这样：程序负责“怎么做”，配置文件负责“使用什么参数”。这就是配置文件最核心的思想。二、为什么需要配置文件？配置文件主要解决三个问题。1. 配置和代码分离代码负责逻辑：连接CAN 初始化工具 执行操作 记录日志配置文件负责参数：CAN1 500000 日志目录 超时时间这样修改参数的时候，不需要修改程序。2. 不同项目使用不同配置例如：项目 ACAN1 500000 ECU_A项目 BCAN2 250000 ECU_B程序完全可以保持不变。只需要替换：config_A.yaml config_B.yaml3. 方便自动化对于 AI Agent、CI/CD 和自动化测试系统来说，配置文件非常重要。例如：Agent ↓ 读取配置 ↓ 初始化工具 ↓ 连接ECU ↓ 执行任务整个过程可以不需要人工修改代码。三、YAML 是什么？YAML 是一种非常适合人阅读和编辑的数据格式。它的特点是：语法简单层级清晰支持注释适合配置人类可读性好例如一个 ECU 环境配置：ecu:name:BCMprotocol:CANchannel:CAN1baudrate:500000logging:enabled:truepath:./logs基本不需要额外解释，就能看懂。四、YAML 基础语法4.1 Key-Value最基本的 YAML：name:ECU_Testversion:1.0enabled:true可以理解为：name → ECU_Test version → 1.0 enabled → true4.2 层级结构YAML 最重要的特点之一就是使用缩进表示层级。例如：ecu:name:BCMprotocol:CANchannel:CAN1baudrate:500000结构相当于：ecu ├── name ├── protocol ├── channel └── baudrate因此 YAML 对缩进比较敏感。工程实践中建议统一使用 2 个空格或者 4 个空格。五、YAML 中的数组YAML 使用-表示数组。例如：supported_protocols:-CAN-LIN-Ethernet也可以配置多个工具：tools:-name:CANoe