GoLand配置Go Modules管理Prometheus客户端依赖需先禁用GOPATH模式、执行go mod init初始化模块，再用go get github.com/prometheus/client_golang@v1.16.0拉取指定版本；确保prometheus.MustRegister()在main开头调用，/metrics端点通过自定义http.ServeMux正确注册，避免404或指标不更新。
GoLand里怎么配置Go module支持采集端依赖管理
Prometheus客户端库依赖 prometheus/client_golang，必须用 Go module 管理，否则 go get 会失败或拉错版本。GoLand 默认可能启用 GOPATH 模式，得手动关掉。
- 打开 Settings → Go → GOPATH，取消勾选 Enable GOPATH mode
- 项目根目录执行
go mod init your-project-name（GoLand 右键目录选 Go → Initialize Module 也行） - 加 client 库：
go get github.com/prometheus/client_golang@v1.16.0（推荐固定 v1.16.x，v1.17+ 的promhttp.Handler默认启用了 CORS 和压缩，可能和旧版 exporter 行为不一致） - 如果
go.mod里出现// indirect标记的golang.org/x/sys或google.golang.org/protobuf，不用手动 clean——它们是 client_golang 的 transitive 依赖，删了反而编译不过
暴露指标 endpoint 时为什么 /metrics 返回 404
常见原因是没注册 handler，或用了错误的 mux 实例。GoLand 调试时容易忽略 HTTP server 启动逻辑是否真绑定了 promhttp.Handler()。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 别直接用
http.Handle("/metrics", promhttp.Handler())—— 这会覆盖默认 mux，导致其他路由失效；改用http.DefaultServeMux显式注册，或更推荐：自建http.ServeMux实例 - 示例：
srv := &http.Server{ Addr: ":8080", Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { if r.URL.Path == "/metrics" { promhttp.Handler().ServeHTTP(w, r) return } http.NotFound(w, r) }), } - 检查 GoLand 的 Run Configuration 是否设置了
Working directory为项目根目录——否则go run main.go可能读不到go.mod，触发 GOPATH fallback，导致promhttp包找不到
在 GoLand 里调试采集逻辑时指标不更新
典型表现：代码里调用 counterVec.WithLabelValues("foo").Inc()，但 curl /metrics 看不到值变化。根本原因常是 metric 注册时机不对，或 label 值拼写不一致。
-
prometheus.MustRegister()必须在main()开始就调用，不能放在某个函数里反复注册（会 panic：“duplicate metrics collector registration attempted”） - label key 名称要全小写、无空格、符合正则
[a-zA-Z_][a-zA-Z0-9_]*；WithLabelValues("Foo")和WithLabelValues("foo")是两个完全不同的指标系列 - GoLand 调试时，右键断点设在 Inc() 行，确认它真被调用；如果采集逻辑跑在 goroutine 里，记得加
time.Sleep()或sync.WaitGroup防止主 goroutine 提前退出 - 用
curl -s http://localhost:8080/metrics | grep your_metric_name直接验证，比刷新浏览器更可靠（浏览器可能缓存）
本地开发时如何模拟 Prometheus 的 scrape 请求
GoLand 本身不提供 scrape 模拟工具，但可以快速验证 endpoint 是否符合规范，避免上线后被 Prometheus 拒绝。
- Prometheus 要求
/metrics返回 plain text，Content-Type 必须是text/plain; version=0.0.4; charset=utf-8；用curl -I http://localhost:8080/metrics看 header - 如果返回
text/plain; charset=utf-8少了 version 字段，说明用了老版本promhttp.Handler()（v1.12 之前），升级 client_golang 即可 - 本地启一个临时 Prometheus 实例验证最准：
docker run -p 9090:9090 -v $(pwd)/prometheus.yml:/etc/prometheus/prometheus.yml prom/prometheus，其中prometheus.yml只配一条 static_configs，target 写localhost:8080 - GoLand 的 Terminal 里运行上述命令后，别忘了在 Run Configurations 里把你的采集端程序设为 “Single instance only”，否则两个进程抢 8080 端口
counterVec 的内部 map，但得展开到 .metricMap 才能看到实际注册的 label 组合——这点容易被忽略。 
