trace.start() 必须在 main() 第一行调用，否则 syscall 阻塞事件全丢失；需传 *os.file、配 defer trace.stop()，并用「syscall blocking profile」分析真实 i/o 延迟。
trace.Start() 必须在 main() 开头调用，否则 syscall 阻塞事件全丢
runtime/trace 不会回溯记录 trace.Start() 之前发生的系统调用——哪怕只是 HTTP server 初始化时的 net.Listen() 或文件打开操作，都会漏掉。你看到的「Syscall blocking」为空或只有零星几个事件，大概率是因为 trace 启动太晚。
常见错误写法：http.ListenAndServe() 后才调 trace.Start()，结果所有 handler 里的 os.ReadFile()、io.Copy() 都没被采集到。
- 正确姿势：在
main()第一行就os.Create("trace.out")，紧接着trace.Start(f) - 别在
init()里调——此时 runtime 尚未初始化，静默失败，文件大小为 0 - 别传路径字符串或
os.Stdout给trace.Start()，必须是 *os.File，否则二进制格式损坏，go tool trace直接拒绝解析
trace.Stop() 必须执行，否则 trace.out 截断无法分析
trace.Stop() 不只是“停止采集”，它负责 flush 缓冲区、写入文件尾部校验信息。如果程序因 log.Fatal()、os.Exit(1) 或 panic 在 trace.Start() 之后、trace.Stop() 之前退出，trace.out 就只剩头尾几个字节，go tool trace 报 EOF 或 unknown magic number。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 务必用
defer trace.Stop()，且确保它在main()返回前执行 - 不要在子 goroutine 中调
trace.Start()—— 它只能在主线程初始化一次 - 验证是否有效：运行后执行
ls -l trace.out，大小应 >1KB；file trace.out应输出Go execution trace
看 syscall 阻塞要盯紧「Syscall blocking profile」，不是「View trace」主图
很多人打开 go tool trace 后直接点「View trace」，拖着时间轴找红条，结果错过关键线索。真正定位 read、write、open 等阻塞位置，得进左上角菜单选「Syscall blocking profile」。
- 这里会列出所有系统调用类型及其总阻塞时间，按耗时倒序排列；
read占比高，说明磁盘或 NFS 响应慢 - 点击具体 syscall 条目（如
read），会跳转到对应 goroutine 的阻塞帧，显示源码行号和调用栈 - 注意区分：
time.Sleep()不会出现——它是主动让出 CPU；但http.Get()里的 body 读取、os.Open()后的Read()都会触发 syscall 阻塞 - 单次阻塞 >1ms 基本可判定是 I/O 层延迟，而非 Go 调度问题
trace 文件太大或采样不足？控制采集窗口比调参数更有效
runtime/trace 默认每秒写入数 MB，高并发下 30 秒 trace 可达 10MB+，既难下载又拖慢分析。别折腾 GODEBUG 调采样率，直接用时间窗控制更可靠。
- 对短任务：加
time.Sleep(200 * time.Millisecond)确保有足够事件写入，避免只录到ProcStart - 对长服务：用
time.AfterFunc(30 * time.Second, trace.Stop)自动停采，不依赖进程退出 - 线上环境慎用全量 trace，优先走
/debug/pprof/trace?seconds=20动态抓取，避免重启 - 别把
trace.Start()放在高频 handler 里反复启停——trace 启动本身有开销，且文件只能写一次
真实 I/O 阻塞点藏在 syscall 层，不在函数耗时里。你看到 os.ReadFile() 慢，未必是它写得差，可能是底层 read 被磁盘卡住；而 go tool trace 是唯一能告诉你“卡在哪一行、等哪个 syscall、持续多久”的工具——前提是 trace 文件完整、采集窗口覆盖真实业务路径。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
