docs(doc): 同步验证脚本自动比对说明

This commit is contained in:
Lane0218
2026-03-12 15:56:41 +08:00
parent 192907a225
commit b008cde14e
6 changed files with 12 additions and 10 deletions

View File

@@ -81,7 +81,7 @@ cmake --build build -j "$(nproc)"
./build/bin/compiler --emit-parse-tree test/test_case/simple_add.sy
```
推荐使用统一脚本验证 “IR -> LLVM 后端 -> 可执行程序” 整体链路,用于验证 IR 的正确性:
推荐使用统一脚本验证 “IR -> LLVM 后端 -> 可执行程序” 整体链路`--run` 模式下会自动读取同名 `.in`,并将程序输出与退出码和同名 `.out` 比对,用于验证 IR 的正确性:
```bash

View File

@@ -79,10 +79,10 @@ cmake --build build -j "$(nproc)"
./build/bin/compiler --emit-asm test/test_case/simple_add.sy
```
推荐使用统一脚本验证 “源码 -> 汇编 -> 可执行程序” 整体链路,用于验证后端代码生成的正确性:
推荐使用统一脚本验证 “源码 -> 汇编 -> 可执行程序” 整体链路`--run` 模式下会自动读取同名 `.in`,并将程序输出与退出码和同名 `.out` 比对,用于验证后端代码生成的正确性:
```bash
./scripts/verify_asm.sh test/test_case/simple_add.sy test/test_result/asm --run
```
若最终输出 `退出码: 3`,说明当前最小子集示例 `return a + b` 的完整后端链路已经跑通。
若最终输出 `输出匹配: test/test_case/simple_add.out`,说明当前最小子集示例 `return a + b` 的完整后端链路已经跑通。

View File

@@ -135,7 +135,7 @@ cmake --build build -j "$(nproc)"
./build/bin/compiler --emit-asm test/test_case/simple_add.sy
```
推荐继续使用统一脚本验证 “源码 -> 汇编 -> 可执行程序” 整体链路,用于做最小回归:
推荐继续使用统一脚本验证 “源码 -> 汇编 -> 可执行程序” 整体链路`--run` 模式下会自动读取同名 `.in`,并将程序输出与退出码和同名 `.out` 比对,用于做最小回归:
```bash
./scripts/verify_asm.sh test/test_case/simple_add.sy test/test_result/asm --run

View File

@@ -209,11 +209,11 @@ cmake --build build -j "$(nproc)"
### 8.2 语义回归
```bash
```bash
./scripts/verify_ir.sh test/test_case/simple_add.sy test/test_result/ir --run
./scripts/verify_asm.sh test/test_case/simple_add.sy test/test_result/asm --run
```
```
目标:优化后程序行为与优化前保持一致。
目标:脚本自动读取同名 `.in`,并将程序输出与退出码和同名 `.out` 比对,确保优化后程序行为与优化前保持一致。
---

View File

@@ -161,6 +161,8 @@ cmake --build build -j "$(nproc)"
./scripts/verify_asm.sh test/test_case/simple_add.sy test/test_result/asm --run
```
`--run` 模式下脚本会自动读取同名 `.in`,并将程序输出与退出码和同名 `.out` 比对。
### 9.2 优化效果对比(示例)
```bash