trace.start()必须在main()第一行调用，否则syscall阻塞、gc初始化等早期事件全丢失；需传*os.file、配defer trace.stop()确保完整写入，文件大小应>1kb。
GoLand里trace.Start()写在哪才有效
必须在main()函数第一行执行，晚于任何goroutine启动、HTTP server listen或第三方库初始化都会漏掉关键事件。比如把trace.Start(f)放在http.ListenAndServe()之后，早期的accept、syscall阻塞、GC初始化阶段就全丢了。
常见错误：defer trace.Stop()写在main()末尾但没处理panic——程序panic退出时defer不执行，trace文件为空；正确做法是用os.Exit(0)前显式调用trace.Stop()，或用runtime.SetFinalizer兜底（不推荐，仅作保险）。
-
f必须指向可写的本地路径，不能是/tmp/trace.out（某些容器环境/tmp是内存盘，写入失败静默） - 目录需提前
mkdir -p ./traces并确保GoLand运行用户有权限 - 不要用
os.Stderr——GoLand捕获stderr会截断二进制trace数据，导致打开白屏
在GoLand中打开trace后看不到GC pause或Syscall blocking
不是工具问题，是trace文件本身没录到这些事件。GoLand的trace查看器只是渲染层，它显示的内容完全取决于runtime/trace采集到了什么。
重点检查三件事：GODEBUG=gctrace=1日志里有没有gc N @X.XXs Y+Z+A ms clock这类输出？没有说明GC根本没触发；go tool trace -http=:8080 trace.out在浏览器里能不能看到“Syscall blocking profile”？能说明trace文件正常，GoLand只是渲染异常。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- GoLand trace查看器依赖Chromium内核，禁用硬件加速或使用精简Linux镜像时UI常白屏——此时直接浏览器打开更可靠
- trace文件小于1MB基本无效：GC pause、syscall blocking等事件需要一定时间跨度才能被采样到，建议至少运行30秒以上再停止
- 没看到“GC pause”红色竖条？可能服务太轻量，或者GC被
GOMEMLIMIT压制住了，先查runtime.ReadMemStats().NumGC是否为0
如何让GoLand trace视图准确定位到某次HTTP请求的GC影响
不能靠自动关联。runtime/trace不记录HTTP请求ID或context值，它只记录goroutine ID和系统事件时间戳。想把一次请求和它的GC停顿挂上钩，必须手动打点。
在HTTP handler开头加trace.WithRegion(ctx, "http.handle")，结尾再套一层trace.WithRegion(ctx, "http.cleanup")。这样在GoLand trace UI里就能看到横向的“user region”色块，和旁边的“GC pause”竖条对齐比对——如果某个region块正中间压着一个2ms的GC pause，那这次请求延迟大概率被拖了。
- 别用
trace.Log()替代WithRegion()：Log只打时间戳，没有持续时间，无法看出GC是否发生在执行中 - region名称要带业务语义，比如
"db.query"或"cache.get"，避免全用"handleRequest"导致所有调用混成一条线 - 同一个region名多次调用会被合并显示，想区分不同请求实例，得在名字里拼入request ID（如
"http.handle." + req.Header.Get("X-Request-ID")）
为什么GoLand里点“Open Trace File…”后timeline全是空白
90%的情况是trace文件损坏或未完整写入。最典型的场景：程序启动后立刻崩溃，或trace.Start()后没等几秒就退出，文件只有header没body。
验证方法：用file trace.out看输出是不是trace.out: data；用head -c 32 trace.out | hexdump -C看前32字节是不是go tool trace 0.001开头的魔数。如果不是，说明trace.Start()失败了但你没检查返回值。
-
trace.Start()返回error，必须显式判断，它不会panic也不会log - Windows下路径含中文或空格会导致
os.Create()失败，但错误被忽略 - GoLand的“Run with Profiling”按钮默认不启用trace，它只走pprof流程——必须自己写代码启动
GODEBUG=gctrace=1日志和file trace.out输出，比改IDE配置快十倍。
