goland 本身不提供监控告警能力，真正起作用的是 go 代码 + prometheus/client_golang + 外部 prometheus/alertmanager；配置重点在项目结构、运行参数和调试方式，而非 ide 界面选项。
GoLand 本身不提供监控告警能力，它只是个 IDE；真正起作用的是你写的 Go 代码 + prometheus/client_golang + 外部 Prometheus/Alertmanager。配置重点不在 GoLand 界面选项里，而在项目结构、运行参数和调试方式上。
go.mod 和依赖必须显式初始化
别依赖 GoLand 的“自动导入”或右键“Add as Go module”，它可能跳过 GO111MODULE=on 检查，导致 go mod init 推导出错误的 module 名（比如从 $GOPATH/src 下启动就容易变成 src/xxx）。
- 在终端里 cd 到空目录（非
$GOPATH/src），手动执行：go mod init myapp - 立即加依赖：
go get github.com/prometheus/client_golang/prometheus和github.com/prometheus/client_golang/prometheus/promhttp - 检查
go.mod文件是否真实写入了这两行，而不是空着或被 IDE 缓存掩盖
运行配置要绕过默认的 “Run kind: File”
GoLand 默认用 go run main.go 启动，但监控服务需要长期运行并响应 HTTP 请求，直接跑单文件会导致 /metrics 端口监听失败或指标注册丢失。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 改用 “Run kind: Package”，目标设为
main包 - 在 “Program arguments” 里留空，不要填任何 flag —— 监控逻辑应由代码内硬编码或环境变量控制，而非命令行传参干扰启动流程
- 勾选 “Allow running in parallel”，方便同时启服务 + 启本地 Prometheus 实例做验证
调试时必须验证 /metrics 是否真实可访问
GoLand 的 Debug 模式会附加 dlv，但不会自动帮你 curl；很多“指标没上报”的问题，其实压根没暴露成功。
- 服务启动后，立刻在终端执行：
curl -s http://localhost:8080/metrics | grep http_requests_total（假设你注册了这个指标） - 如果返回空，说明
prometheus.MustRegister()没被执行（比如写在了某个未调用的 init 函数里），或http.Handle("/metrics", ...)被覆盖/漏注册 - 别信 GoLand 控制台里“Server started on :8080”就等于一切就绪 —— 它只表示监听成功，不保证路由和指标注册正确
环境变量需在 Run Configuration 里手动注入
GoLand 不会自动继承系统 shell 的 GOROOT、GO111MODULE 或自定义配置（如 PROMETHEUS_ADDR），而这些对监控服务行为影响很大。
- 进 “Environment variables”，添加：
GO111MODULE=on、GOPROXY=https://proxy.golang.org,direct - 如果你的服务读取
LISTEN_ADDR控制绑定地址（例如要让 Prometheus 容器能访问），必须在这里显式设为LISTEN_ADDR=:8080，不能只靠代码默认值 - 修改后点 “Apply”，再重启 —— GoLand 不会热重载环境变量
最容易被忽略的是：GoLand 的 Terminal 默认用的是 IDE 自带的 shell 环境，跟系统终端 PATH 不一致。哪怕你本地 which go 正常，GoLand 里新开 Terminal 可能仍找不到 go，导致 go mod 报错。每次换新项目，先在 GoLand Terminal 里敲一遍 go version 确认环境干净。
