testscript 是 golang.org/x/tools/cmd/testscript 提供的专用 CLI 测试框架，用于验证命令行行为，相比标准 testing 包更易处理管道、重定向、退出码及跨平台环境隔离。
testscript 是什么，为什么不用标准 testing 包
testscript 不是 Go 标准库的一部分，而是 golang.org/x/tools/cmd/testscript 提供的专用 CLI 测试框架。它适合验证命令行行为：输入命令、检查输出、校验文件变化、模拟环境变量或信号——这些用 testing 手动写太碎，容易漏掉 shell 语义（比如管道、重定向、退出码）。标准测试里调 exec.Command 可以做，但状态管理、路径清理、跨平台换行符、临时目录隔离都得自己兜底。
常见错误现象：os.RemoveAll 清不干净导致后续测试失败；没设 env: GOPATH= 导致 go run 行为不一致；用 t.Log 输出掩盖了实际 stderr 内容。
- testscript 每个测试用例自动创建独立临时目录，执行完自动清理
- 支持内建命令如
stdout、stderr、exit，直接断言输出和退出码 - 脚本语法接近 shell，但跨平台（Windows 下也认
/路径分隔符）
怎么写一个最小可运行的 testscript 测试
先确保已安装：go install golang.org/x/tools/cmd/testscript@latest。测试脚本必须放在 testdata/script/ 目录下，后缀为 .txt，比如 testdata/script/hello.txt：
#!/usr/bin/env testscript # hello.txt go run ../cmd/mytool --help stdout 'Usage: mytool' exit 0
对应 Go 测试入口只需几行：
立即学习“go语言免费学习笔记（深入）”；
func TestScripts(t *testing.T) {
testscript.Run(t, testscript.Params{
Dir: "testdata/script",
})
}关键点：
- 脚本第一行必须是
#!/usr/bin/env testscript，否则被跳过 -
Dir指向含.txt文件的目录，不是单个文件 - 脚本中所有路径都相对于
Dir，../cmd/mytool是从testdata/script/往上找 - 默认不继承当前环境变量，需显式用
env VAR=value设置
如何在 testscript 中模拟真实 CLI 场景
CLI 工具常依赖外部命令、文件系统状态、环境变量或用户输入。testscript 提供原生支持，但要注意边界：
常见错误现象：脚本里写 ls -l 却没声明 env PATH=，导致 Linux 下跑 Windows 测试失败；用 cat file 读空文件时没加 ! stderr，结果因权限提示误判失败。
- 用
env PATH=/bin:/usr/bin控制可用命令集，避免 CI 环境差异 - 用
mkdir dir、write file content、cmp file expect.txt构造输入文件 - 用
! stdout或! stderr断言“无输出”，比stdout ''更安全（后者会匹配空行，但可能有换行符） - 用
exec mytool arg1 arg2替代裸写mytool arg1 arg2，避免和内建命令冲突
testscript 的坑：路径、编码、Windows 兼容性
testscript 在 Windows 上默认用 CRLF 换行，但脚本里写的 stdout 'hello\n' 是 LF，会导致匹配失败。这不是 bug，是设计选择：脚本内容按 Unix 风格写，testscript 自动转换输出做归一化——但仅限于 stdout/stderr，不处理 write 生成的文件内容。
性能影响不大，但兼容性要手动兜住：
- 所有
stdout/stderr断言用正则或模糊匹配，比如stdout 'Usage.*mytool'，别死扣换行 - 需要精确文件内容时，用
cmp+write -raw，-raw禁用换行转换 - 避免在脚本里用
cd ..，testscript 的工作目录是临时目录，相对路径应始终基于该起点 - Go 1.21+ 默认启用
GOEXPERIMENT=arenas，某些旧版 testscript 会 panic，建议锁死golang.org/x/tools版本
最易被忽略的是：testscript 不解析 Go 源码，也不关心你的 CLI 是否用了 cobra/viper。它只管“命令敲进去，输出对不对”。所以参数解析逻辑出错，得靠它来暴露；但结构体字段绑定失败这种深层问题，还得靠单元测试补位。
