一、YAML 本身是干嘛的？
YAML = Yet Another Markup Language（或 YAML Ain’t Markup Language）
它是一种人类可读的配置语言，特点是：
- 用 缩进 表示层级（像 Python）
- 用
:和-表示键值对和列表 - 几乎没有多余符号（不像 JSON 那么多
{}[]）
✅ 易读
✅ 易写
✅ 非常适合 CI / 容器 / 云原生配置
二、在 GitLab CI 里，YAML 具体“管什么”？
.gitlab-ci.yml 负责描述 整个流水线（Pipeline）：
| 概念 | YAML 里怎么体现 |
|---|---|
| 有哪些阶段 | stages: |
| 有哪些任务 | job 名（如 compile、smoke） |
| 任务属于哪个阶段 | stage: |
| 在哪个 Runner 上跑 | tags: |
| 跑哪些命令 | script: |
| 什么时候跑 | rules: / when: |
| 产物怎么保存 | artifacts: |
三、一个最小 YAML 示例（对比 Makefile）
Makefile 写法
regression:vcs -sverilog top.sv
GitLab CI 的 YAML 写法
regression:stage: testtags: [uvm-sim]script:- source /tools/eda_setup.sh- vcs -sverilog top.sv
📌 区别：
- Makefile：你手动执行
- YAML：GitLab 自动解析并执行
四、YAML 在 UVM平台 回归中的真实角色
你的 .gitlab-ci.yml 实际在做这些事：
# 告诉 GitLab：
# 1️⃣ 先编译
# 2️⃣ 再冒烟
# 3️⃣ 最后全量回归
# 并且每一步都用 EDA 服务器的 shell 跑
相当于把原来你手动敲的命令：
ssh eda-server
cd project
source setup.sh
make regress
变成 GitLab 自动调度、自动记录结果、自动保存 log。
五、YAML 的几个“必须知道”的坑
❌ 1️⃣ 缩进不能用 Tab
job:script: # ❌ Tab
✅ 必须用空格：
job:script:- echo hello
❌ 2️⃣ 少一个 - 就全错
script:echo hello # ❌
✅ 正确：
script:- echo hello
❌ 3️⃣ 多行命令要小心
script:- |source /tools/setup.shmake compilemake run
六、YAML ≠ 脚本
| YAML | Shell Script |
|---|---|
| 描述“要做什么” | 描述“怎么做” |
| GitLab 解析 | Bash 执行 |
| 声明式 | 命令式 |
| 不负责计算 | 负责计算 |
✅ YAML 里不写复杂逻辑
✅ 复杂逻辑交给 Python / Makefile / Shell