必须禁用-ldflags="-s -w"构建带符号表的二进制，GoLand仅辅助启动和调用pprof；需确保路由注册到DefaultServeMux、pprof命令同时传二进制和profile、火焰图用-raw导出stack后渲染。
GoLand 本身不直接运行或解析 pprof 数据，它只是帮你启动带调试信息的 Go 程序、生成 profile 文件、再调用 go tool pprof 命令——真正定位瓶颈靠的是 Go 工具链和你对采样逻辑的理解。配置错一步，比如构建时 strip 了符号，GoLand 再方便也只会给你一堆 0x456789。
GoLand 启动服务前必须禁用 -ldflags="-s -w"
这是最常被忽略的一步。GoLand 默认构建配置里可能没显式写 -ldflags，但如果你在 Run Configuration → Go Build → Flags 里手动加过 -s -w，或者用了 CI/CD 流水线传进来的构建参数，那 profile 就永远看不到函数名。
- 打开 Run → Edit Configurations… → 选中你的服务配置 → Go Build 标签页
- 确认
Flags输入框为空，或明确写成-ldflags=""（清空默认值） - 构建后验证：执行
file ./your-binary，输出应含with debug_info；或readelf -S ./your-binary | grep debug有结果 - 若已构建出 stripped 二进制，GoLand 重跑没用，必须删掉重新 build
在 GoLand 里正确触发 HTTP pprof 接口
GoLand 启动程序后，net/http/pprof 的路由只注册到 http.DefaultServeMux。如果你的代码用了 Gin/Echo/Chi 或自定义 http.ServeMux，访问 /debug/pprof/ 会 404——这不是 GoLand 的问题，是路由没桥接过去。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 纯
net/http服务：确保http.ListenAndServe(":6060", nil)第二个参数为nil - Gin 框架：加一行
r.GET("/debug/pprof/*pprof", gin.WrapH(http.DefaultServeMux)) - Echo 框架：用
e.Group("/debug/pprof").Use(middleware.WrapHandler(http.DefaultServeMux)) - 启动后立刻在终端执行
curl http://localhost:6060/debug/pprof/，返回 HTML 才算成功
用 GoLand Terminal 调用 go tool pprof 时必须传二进制路径
GoLand Terminal 是最顺手的操作环境，但很多人在这里输错命令：只传 profile URL 或文件，漏掉服务二进制。结果 top 里全是 runtime.mcall，以为程序没热点，其实是 pprof 根本没映射上。
- CPU 采样（推荐）：
go tool pprof ./myapp http://localhost:6060/debug/pprof/profile?seconds=30 - 离线分析（如 benchmark 生成的）：
go tool pprof ./bench.test cpu.out - 进交互模式后第一件事是输
top，看到第一列是main.handleRequest这类名字才算加载成功 - 别信
go tool pprof -http=:8080的 Web UI —— 它依赖dot，GoLand 自带 terminal 通常没装 Graphviz
火焰图必须导出 folded stack 再用 flamegraph.pl
GoLand Terminal 里执行 go tool pprof -svg 画的是调用图（callgraph），不是火焰图（flame graph）。想看宽度代表耗时占比的火焰图，必须走标准流程。
- 先导出文本：
go tool pprof -raw -lines ./myapp cpu.out > stacks.txt - 再渲染：
./flamegraph.pl stacks.txt > flame.svg（需提前下载flamegraph.pl） -
-raw参数不能省，否则flamegraph.pl解析失败，生成空 SVG - 火焰图里别盯颜色深浅或高度，只看矩形宽度——最宽那条就是你要优化的 hot path
真正卡住人的从来不是 GoLand 怎么点按钮，而是构建时有没有符号、路由有没有挂载、pprof 命令有没有传对二进制、火焰图有没有用 -raw 导出。这四步任意一个断掉，你看到的就不是瓶颈，而是工具链的报错现场。
