Go程序需显式调用os.Getenv读取Docker传入的环境变量，无法自动绑定到结构体；变量在容器启动时固化，区分大小写，空字符串与未设置不可区分，解析时须处理错误并设默认值。
Go 程序怎么读取 Docker 传进来的环境变量
Go 本身不自动加载环境变量到结构体或配置对象里，os.Getenv 是唯一可靠入口。Docker 传入的变量和本地 export 的行为完全一致，只是生命周期绑定容器启动时的上下文。
常见错误是以为写个 config.Port 就能自动从 PORT 环境变量取值——不会。必须显式调用 os.Getenv("PORT") 或用第三方库做映射。
- 所有环境变量在容器启动瞬间固化，运行中修改
/proc/sys/kernel/xxx或 exec 新进程不会影响已运行的 Go 进程 - 变量名区分大小写，
DB_HOST和db_host是两个变量 - 空字符串
""和未设置是不同状态，os.Getenv对未设置变量返回空串，无法区分“设为空”和“根本没设”
Docker run 时怎么传环境变量给 Go 容器
最直接的方式是 docker run -e KEY=VALUE，但要注意 shell 变量展开时机和引号处理。
比如想传含空格的数据库 URL：docker run -e "DATABASE_URL=postgres://user:pass@host/db" —— 必须加双引号，否则空格会让 shell 把命令截断。
立即学习“go语言免费学习笔记（深入）”；
-
-e KEY（只写键名）会把宿主机当前 shell 的$KEY值透传进去，适合本地调试，但 CI/CD 中不推荐依赖宿主机环境 -
--env-file更适合多变量场景，文件内容格式为KEY=VALUE每行一条，注意：文件路径是宿主机路径，且换行符必须是 LF（Windows 记事本保存的 CRLF 会导致值末尾带\r） - 使用
docker-compose.yml时，environment:下写KEY: VALUE或- KEY=VALUE都可以，但后者支持变量插值（如${DB_PORT}），前者不支持
Go 里安全地解析环境变量类型（int、bool、struct）
os.Getenv 只返回 string，直接 strconv.Atoi 或 strconv.ParseBool 有 panic 风险。必须检查错误，且默认值逻辑要明确。
例如端口号：不能假设 os.Getenv("PORT") 一定可转成 int，更不能让程序在生产环境因 panic: strconv.Atoi: parsing "": invalid syntax 崩溃。
- 用
strconv.Atoi(os.Getenv("PORT"))前，先判断os.Getenv("PORT") != ""，否则默认用 8080 - 布尔值别信
"true"/"false"字面量，strconv.ParseBool支持"1"、"t"、"T"、"true"、"TRUE"、"True"，其他都报错；建议统一约定用"0"/"1"降低歧义 - 复杂结构（如数据库连接配置）别手写解析，用
github.com/kelseyhightower/envconfig这类库，它基于 struct tag（如`envconfig:"db_host"`）自动绑定，但要注意它不处理嵌套 struct 的深层环境变量映射
Docker + Go 环境变量常见踩坑点
最隐蔽的问题不是“读不到”，而是“读到了但不是你认为的那个值”。比如镜像构建阶段和运行阶段的环境变量混淆、.env 文件编码问题、Kubernetes ConfigMap 挂载后权限导致读取失败等。
- Dockerfile 里的
ENV指令设的是构建期变量，除非在RUN时用，否则对运行时 Go 程序不可见；运行时变量只来自docker run -e、--env-file或 compose 的environment - 用
docker build --build-arg传参，只影响构建过程，不会自动变成运行时环境变量；要手动在 Dockerfile 里用ENV转存，或在 entrypoint 脚本里重新export - Kubernetes 中挂载 ConfigMap 为环境变量时，如果 ConfigMap key 含下划线（如
db_url），K8s 会原样透传；但 Go 的 struct tag 若写成`envconfig:"DB_URL"`，就匹配不上——变量名必须完全一致，大小写+下划线都不能差
环境变量不是配置终点，而是传递通道。Go 程序得自己决定哪些变量必须存在、哪些允许缺失、哪些需要校验格式。漏掉一个 os.Getenv 的错误检查，线上就可能静默用错端口或连错数据库。
