Go项目践行12-Factor规范的核心是改习惯：配置必须通过环境变量注入、依赖显式锁定、启动单进程、日志输出stdout/stderr、二进制静态链接，且所有环节从首次commit就严格执行。
Go项目要符合12-Factor规范，核心不是“加功能”，而是“改习惯”：把配置从代码里抠出来、让依赖显式可锁定、用环境变量驱动行为、拒绝硬编码路径或端口。做不到这几点，容器化、CI/CD、多环境部署都会卡在第一步。
配置必须通过环境变量注入，不能写死或放配置文件
12-Factor明确要求配置与代码分离，且只通过环境变量传递。.env 文件只是本地开发的便利手段，不是配置源——它必须被 godotenv.Load() 加载进 os.Environ()，最终所有读取都走 os.Getenv() 或封装后的 Getenv。
- 禁止在结构体字段上写默认值（如
Port int `default:"8080"`），这违反“配置即环境变量”原则 - 敏感配置（如数据库密码）绝不能出现在 Git 里；
.env必须加进.gitignore，只保留.env.example - 使用
configuro或go-env类库时，确保启用WithLoadFromEnvVars("APP")，而非仅靠WithLoadFromConfigFile - Kubernetes 中用
envFrom: secretRef注入，不是挂载 ConfigMap 文件再解析
依赖必须显式声明并锁定版本，禁用隐式全局安装
Go 的 go.mod 天然支持显式依赖管理，但容易踩坑的是间接依赖和构建时行为。
-
go mod vendor不是必须项，但若使用，需确认vendor/modules.txt和go.sum一致，且 CI 流程中启用GOFLAGS="-mod=vendor" - 禁止在
Dockerfile中执行go get xxx动态拉包——这会让镜像构建不可重现 - 第三方工具（如
cobra-cli）应固定版本安装：go install github.com/spf13/cobra-cli@v1.9.0，避免@latest引入意外变更 - 系统级依赖（如 Redis CLI、jq）若必须存在，应在
Dockerfile中用apt-get install -y --no-install-recommends显式声明，不依赖基础镜像“恰好有”
启动命令必须无参数、无状态、单进程
12-Factor 要求应用以单个前台进程启动，不 fork 后台服务，不管理子进程生命周期。
立即学习“go语言免费学习笔记（深入）”；
-
main()函数最后调用http.ListenAndServe()或cmd.Execute()即可，不要包装成 goroutine 启动 - 拒绝用
supervisord、systemd或自研守护进程管理 Go 二进制——容器编排层（K8s/Docker）负责重启，应用只管自己退出 - 信号处理只响应
SIGTERM做优雅退出，不监听SIGHUP重载配置（配置本就不该热更新） - 日志直接输出到
stdout/stderr，不写文件；日志格式保持纯文本，不加颜色、不加前缀（由日志收集器统一打标）
构建产物必须静态链接、零运行时依赖
Go 默认静态编译是天然优势，但容易因 CGO 或第三方库引入动态依赖，破坏“一份二进制，随处运行”。
- 构建命令必须加
CGO_ENABLED=0：CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o app . - 若必须用 CGO（如连接 PostgreSQL 的
pgx），则基础镜像不能用scratch，改用gcr.io/distroless/static:nonroot并显式拷贝libc - 检查最终二进制是否真静态：
file app输出含statically linked；ldd app应提示not a dynamic executable - 镜像用
FROM scratch时，确保没漏掉证书文件——用ca-certificates静态嵌入或挂载/etc/ssl/certs
最容易被忽略的是“环境变量覆盖优先级”：本地 .env 不能覆盖生产环境注入的 DATABASE_URL，否则上线就连错库。真正的 12-Factor 实践，是从第一次 git commit 就把 APP_ENV 当作必需字段，而不是等上生产才发现配置逻辑散落在三个地方。
