GoLand 启动前必须设对的三个环境变量是GOOS、GOARCH和GOPROXY；GOOS需设为linux以匹配云原生部署目标，GOARCH根据K8s节点架构选amd64或arm64，GOPROXY必须设为https://goproxy.cn,direct以避免模块下载卡顿或404错误。
GoLand 启动前必须设对的三个环境变量
GoLand 调试失败、模块识别错乱、甚至 go run 报 cannot find package，八成是环境变量没对齐。Mac M1/Windows WSL/Linux 都得手动确认这三项：
-
GOOS=linux：云原生部署目标是 Linux 容器，本地开发时也应统一；设成darwin或windows会导致后续交叉编译出错 -
GOARCH=amd64（或arm64）：根据你最终部署的 K8s 节点架构决定；M1 本地开发建议设arm64，但 CI 构建镜像时要切回amd64（除非集群全是 ARM 节点） -
GOPROXY=https://goproxy.cn,direct：国内必须设，否则go mod download卡住或报 404；私有模块加GONOPROXY=git.example.com/mygroup/*
在 GoLand 的 Preferences → Go → GOPATH and GOROOT → Environment 里填，别只靠终端 shell 配置——IDE 不读你的 ~/.zshrc。
调试容器内进程：dlv 远程调试配置要点
直接在 GoLand 里点 ▶️ 跑起来的不是云原生服务，它没走 Dockerfile、没挂 ConfigMap、也没受 K8s 探针约束。真要验证线上行为，得用 dlv attach 到容器里：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 构建镜像时必须带
CGO_ENABLED=0，否则 dlv 无法注入；dlv自身依赖 libc，而scratch镜像没有 - Dockerfile 里加
COPY --from=builder /usr/local/go/bin/dlv /dlv，并暴露调试端口（如EXPOSE 2345） - GoLand 新建 Attach to Process 配置，Host 填容器 IP（
docker inspect -f '{{.NetworkSettings.IPAddress}}' <container>），Port 填 2345，Program path 填容器内二进制路径（如/app） - 启动容器时加
-security-opt seccomp=unconfined，否则 dlv 在某些 Kubernetes 环境下被 SELinux 拦截
viper 配置热更新在 GoLand 里不生效？检查挂载方式
v.WatchConfig() 在 IDE 里跑没问题，一塞进容器就监听不到 ConfigMap 变更，问题不在代码，在挂载。
- 必须用
subPath或整个目录挂载（如/etc/config），不能只挂单个文件；fsnotify监听的是目录 inode 变更，单文件挂载会丢失事件 - GoLand 默认工作目录是项目根，但容器里
/etc/config是空目录——调试时手动在 IDE 的 Run Configuration → Working directory 设为/tmp/config-test，再把 ConfigMap 内容复制进去模拟 -
v.OnConfigChange回调里别直接改全局 struct；先v.Unmarshal(&cfg)到新结构体，再原子替换指针，避免并发读写 panic
K8s 探针端口和 SIGTERM 处理在调试中容易漏掉
GoLand 调试默认只起主服务，/healthz 端口没开、SIGTERM 信号收不到，结果 CI 测通了，上线就 CrashLoopBackOff。
- 调试配置里加 Program arguments：
--health-port=8081 --http-port=8080，让主服务和探针端口分离；否则中间件（JWT、日志）会拦截/healthz - 在 main 函数开头加
signal.Notify(sigChan, syscall.SIGTERM, syscall.SIGINT)，并在 goroutine 里阻塞等待；GoLand 默认不转发信号，需勾选 Run Configuration → Environment → Pass environment variables to subprocesses -
http.Server.Shutdown()必须设超时（如10 * time.Second），否则调试时卡死；返回值要判context.DeadlineExceeded并 log
真正麻烦的不是写代码，是让本地调试环境逼近 K8s 真实约束——端口、信号、挂载、静态链接，漏一个，上线就翻车。
