go 不自动加载 .env 文件，需手动注入或用 godotenv 等工具；os.getenv 返回空字符串易掩盖缺失问题，应优先用 os.lookupenv 校验必要变量是否存在。
Go 项目里环境变量不是靠 .env 文件自动加载的——标准库不读它，os.Getenv 只查操作系统层面已设置的变量。想让配置生效，得手动注入或借助工具补足这一环。
Go 程序启动前必须确保环境变量已存在
Go 运行时不会解析项目根目录下的 .env，也不会在 main() 执行前自动加载。常见错误是直接写 os.Getenv("DB_URL") 却没提前设值，结果返回空字符串，连接失败却无明确报错。
- Linux/macOS 启动前用
export DB_URL="postgres://..." && go run main.go - Windows CMD 用
set DB_URL=postgres://... && go run main.go - Docker 中通过
ENV指令或-e参数传入 - CI/CD 流水线（如 GitHub Actions）需在
env:块中显式声明
用 github.com/joho/godotenv 加载 .env 文件
这是最轻量、最常用的补充方案，适合本地开发和测试。它只做一件事：把 .env 文件内容 parse 成键值对，再调用 os.Setenv 注入进程环境。
- 文件路径默认为当前工作目录下的
.env；可传参指定，如godotenv.Load(".env.local") - 重复 key 会覆盖，后加载的文件优先级更高
- 不支持嵌套变量（如
PORT=3000，ADDR=localhost:$PORT不会自动展开） - 务必在
main()开头尽早调用，否则后续依赖环境变量的初始化（如数据库连接）可能读到空值
示例：
PHP商城系统是国内领先商城系统,网店系统,购物系统,网上商城系统,B2C商城系统产品.同时也是一个商业的PHP开发框架。PHP 商城系统由内容、文章、会员、留言、订单、 财务、广告、短消息、数据库管理、营销推广、内置支付管理、商品配送管理、无限级分类、全站搜索等多个功能模块插件组成。在当今瞬机万变的市场环境中，快速高效的IT解决方案是您业务成功的关键。我们PHP商城系统能为您量身打造完全符合需求
立即学习“go语言免费学习笔记（深入）”；
func main() {
_ = godotenv.Load() // 忽略错误，生产环境通常不依赖 .env
dbURL := os.Getenv("DB_URL")
// ...
}
区分开发、测试、生产环境的变量来源
硬编码或混用 .env 容易导致敏感信息泄露或配置错乱。关键原则：开发用 .env，测试用临时覆盖，生产只认系统环境变量或 Secret Manager。
- 本地开发：
.env+godotenv，加.gitignore防提交 - 单元测试：
os.Setenv在TestMain或每个TestXxx前设置，用os.Unsetenv清理 - 生产部署：禁止读取任何本地
.env文件；K8s 用Secret挂载，Docker Compose 用env_file（注意它是在容器启动时注入，不是 Go 进程读取） - 配置结构体建议用
github.com/spf13/viper统一管理，但它仍依赖底层环境变量是否已就位
os.LookupEnv 比 os.Getenv 更安全
os.Getenv 对未设置的 key 返回空字符串，容易掩盖“变量缺失”问题；而 os.LookupEnv 返回 (value string, ok bool)，能明确区分“值为空”和“变量未定义”。
- 启动校验时优先用
os.LookupEnv判断必要变量是否存在 - 例如：
if dbURL, ok := os.LookupEnv("DB_URL"); !ok { log.Fatal("missing required env: DB_URL") } - 避免在日志中打印空值误判为“配置成功”，实际是变量根本没设
真正麻烦的从来不是怎么读环境变量，而是谁在什么时候、以什么顺序、从哪一层把它塞进进程——尤其当 Docker、K8s、Makefile、IDE Run Config 多层叠加时，os.Getenv 返回空，往往意味着某一层漏掉了注入，而不是 Go 代码写错了。
