goland 本身不内置 trace 可视化，但可通过配置启动参数并手动调用 trace.start() 生成 trace.out 文件，或通过 /debug/pprof/trace 动态抓取；推荐后者以避免文件权限与写入失败问题。
GoLand 里直接启动带 trace 的程序
GoLand 本身不内置 trace 可视化，但能帮你干净地生成 trace.out 文件——关键在启动配置里加 runtime/trace 初始化逻辑。别依赖“自动注入”，必须自己写代码并确保它在 main 入口最早执行。
- 在
main()函数开头立即调用trace.Start()，文件路径要可写（比如./trace.out），且不能被多次调用（trace.Stop()必须配对） - 不要把
trace.Start()放进 HTTP handler 或 goroutine 里——它只应全局启用一次，否则静默失败或覆盖文件 - GoLand 的 Run Configuration 中，“Program arguments” 不需要额外参数；但务必勾选 “Add content root to GOPATH” 和 “Allow running in background”，避免因 IDE 临时中断导致 trace 写入失败
- 如果程序提前 panic 或 os.Exit，
defer trace.Stop()不会执行 →trace.out是空文件或损坏。建议加os.Atexit()回退（Go 1.22+）或用runtime.SetFinalizer做兜底
GoLand 启动 pprof HTTP 接口后在线抓取 trace
比起本地写文件，更推荐用 GoLand 启动服务后，通过 /debug/pprof/trace?seconds=20 动态抓取——不用改代码、不担心文件权限、适合反复验证。
- 先确认代码里有
import _ "net/http/pprof"，且 HTTP server 已注册到http.DefaultServeMux（或手动挂载到自定义 mux） - GoLand 运行配置中，Working directory 设为项目根目录（否则
localhost:6060/debug/pprof/可能 404） - 启动后立刻在终端执行：
wget http://localhost:6060/debug/pprof/trace?seconds=20 -O trace.out；若无 wget，用 curl：curl -o trace.out "http://localhost:6060/debug/pprof/trace?seconds=20" - 注意：该接口默认采样 1 秒，
seconds=20才真抓 20 秒。时间太短（如seconds=1）可能错过关键阻塞事件
在 GoLand 里打开和分析 trace.out
GoLand 不解析 .out 文件，但可以一键调用系统命令打开 go tool trace Web 界面——前提是本地装了 Go SDK 且 PATH 正确。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 打开 Terminal（Alt+F12），运行：
go tool trace trace.out；成功后会打印类似2026/09/20 19:42:15 Parsing trace... 2026/09/20 19:42:15 Splitting trace...，最后给出 URL（通常是http://127.0.0.1:55555） - 如果报错
command not found: go，检查 GoLand Settings → Go → GOROOT 是否指向有效 SDK；或 Terminal 中手动 source ~/.zshrc（macOS）或刷新环境变量 - 浏览器打开该 URL 后，重点点 “View trace”，拖拽缩放看横向时间轴：绿色条是 Goroutine 执行，灰色是阻塞（
Goroutine blocked on syscall），红色竖线是 GC STW —— 这些比火焰图更能说明“为什么卡住” - 别在 GoLand 自带的 Browser 工具里打开；用 Chrome/Firefox，否则可能加载失败或交互异常
常见失败原因和绕过方式
你在 GoLand 里点 Run 却看不到 trace 数据？大概率不是配置漏了，而是 trace 本身被跳过或截断。
-
trace.Start()返回 error 但被忽略 → 一定要检查返回值，常见原因是文件不可写或已存在且只读 - 程序运行不到 1 秒就退出 →
trace.out为空；加time.Sleep(5 * time.Second)强制保活（仅调试用） - 用了
go run main.go启动 → trace 文件写在临时目录，GoLand 无法定位；改用go build后运行二进制，路径才可控 - GoLand Debug 模式下 trace 失效 → 因为调试器干扰调度器事件捕获；切回 Run 模式再试
GoLand 只是启动和触发工具，真正决定 trace 质量的是你何时调用 trace.Start()、写入路径是否可靠、以及采样窗口是否覆盖了问题发生时段——这些细节比 IDE 设置重要得多。
