go 1.16+是本地调试前提，需执行go version和go env gopath验证；模块路径须与git仓库一致，避免gopath/src下初始化；viper配置加载须分层且优先级明确，容器调试需delve配合正确网络与路径映射。
本地调试前必须确认 Go 版本与模块模式是否就绪
Go 1.16+ 才能稳定支持 viper 的自动环境变量映射和 go.sum 校验，低于该版本在 docker-compose 中拉起容器后常出现依赖解析失败或配置读取为空。执行 go version 和 go env GOPATH 是硬性检查步骤：若 GOVERSION 小于 1.16，go mod init 生成的模块路径可能被错误推导；若 GOPATH 非空且指向旧项目目录，IDE（如 Goland）可能 fallback 到 GOPATH 模式，导致 go run 本地能跑、容器内却报 cannot find module providing package。
- 不要在
$GOPATH/src下新建项目再执行go mod init，模块路径会与目录结构冲突 - 推荐初始化命令：
go mod init github.com/your-org/your-service，路径需与 Git 仓库一致 - 验证模块是否生效：
go list -m all | head -3应输出实际模块名，而非command-line-arguments
用 docker-compose 启动依赖服务时网络和绑定配置易错点
Redis、PostgreSQL 等中间件在 Docker 容器中默认绑定 127.0.0.1 或启用 protected-mode yes，导致 Go 服务容器无法连接——这不是代码问题，是网络拓扑没对齐。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- PostgreSQL 必须显式设置
POSTGRES_PASSWORD，否则日志只显示database system is shut down，实为认证拒绝 - Redis 需覆盖默认
command：redis-server --bind 0.0.0.0:6379 --protected-mode no - Linux 下
host.docker.internal不可用，得在docker-compose.yml中加extra_hosts: ["host.docker.internal:host-gateway"] - 所有服务必须声明同一自定义网络，例如
networks: [app-network]，避免使用默认 bridge 导致 DNS 解析失败
main.go 配置加载顺序必须匹配容器运行时注入方式
硬编码端口、DB 地址或 JWT 密钥会让本地调试和 Kubernetes 部署变成两套逻辑。正确做法是让 viper 分层加载：.env（开发）、config.yaml（测试）、环境变量（生产），且优先级严格遵循“后写入者胜”。
-
viper.AutomaticEnv()会把DB_HOST映射为db.host，调用时必须用viper.GetString("db.host")，不能写成"DB_HOST" -
.env文件必须加入.gitignore，但要提供.env.example，含DB_PORT=5432、REDIS_ADDR=redis:6379等真实键名 - 若用
docker-compose注入环境变量，确保environment:块中字段名与viper查找键一致，比如DB_HOST: "postgres"对应viper.GetString("db.host") - Kubernetes 中 Secret 挂载为文件时，路径如
/etc/config/db_password，需用viper.SetConfigFile("/etc/config/db_password")单独加载，不能混进自动扫描路径
调试容器内 Go 进程必须用 delve 连接而非本地二进制
本地 dlv debug 跑起来的进程监听的是宿主机网络，而容器内服务看到的是独立 netns；直接连 localhost:2345 会失败，且断点位置与容器内源码路径不一致。
- Dockerfile 中需暴露调试端口：
EXPOSE 2345，并添加delve到 builder 阶段：RUN go install github.com/go-delve/delve/cmd/dlv@latest - 启动命令改用：
dlv --headless --listen=:2345 --api-version=2 --accept-multiclient exec ./main - VS Code 的
launch.json中port指向容器映射端口（如2345），host设为127.0.0.1，sourceMap显式声明："./": "/app/" - 别在生产镜像里留
dlv，调试专用镜像应单独 tag，例如:debug，基础镜像用golang:1.22-alpine而非scratch
GOMEMLIMIT 必须设为 400MiB 左右，否则 GC 在接近上限时频繁 STW，导致 /readyz 响应超时，Pod 反复重启。这和代码逻辑无关，是资源约束与 Go 运行时行为的耦合点。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
