godotenv 用于 Go：完整指南及示例

\n\n

godotenv 库是一个便携且轻量级的工具，用于将 .env 格式文件中的环境变量加载到 Go 应用程序的运行环境中。它受同名 Ruby 和 Node.js 库的启发，遵循 “12 Factor App” 原则，即配置应存储在环境变量中。godotenv 允许开发者将敏感数据（API 密钥、数据库密码、连接设置）从源代码中提取到单独的文件中，该文件不会进入版本控制系统。

\n\n

该库的主要任务是简化开发过程中的配置管理。在生产环境中，环境变量通常通过系统机制（Docker、Kubernetes、CI/CD 管道）设置，但在开发者的本地机器上，使用 .env 文件更为方便。godotenv 会自动读取此文件，并通过标准函数 os.Getenv() 使文件中定义的所有变量可用。这省去了编写自定义解析器和处理边界情况的需要。

\n\n

该库支持多行值、注释（以 # 开头的行）、空行以及特殊字符的转义。除了 Go 标准库外，它没有外部依赖，这使其成为微服务和命令行工具的绝佳选择。godotenv 不会覆盖已存在的系统环境变量，从而确保部署时的安全行为。

\n\n

安装

\n\n

要安装该库，请在 Go 项目的根目录下执行以下任一命令：

\n\n

# 安装最新稳定版本\ngo get github.com/joho/godotenv\n\n# 如果您使用 Go Modules（推荐）\ngo get github.com/joho/godotenv@latest\n

\n\n

执行命令后，go.mod 文件中将出现一条依赖记录。请确保您的项目已使用 go mod init 初始化。

\n\n

快速入门

\n\n

在项目根目录下创建一个 .env 文件，内容如下：

\n\n

# .env 文件\nAPP_NAME=MySuperApp\nDB_HOST=localhost\nDB_PORT=5432\nDB_USER=admin\nDB_PASSWORD=secret123\nSECRET_KEY=my-super-secret-key\n

\n\n

现在编写一个简单的 Go 程序来加载此文件并输出变量值：

\n\n

package main\n\nimport (\n    "fmt"\n    "log"\n    "os"\n\n    "github.com/joho/godotenv"\n)\n\nfunc main() {\n    // 加载 .env 文件\n    err := godotenv.Load()\n    if err != nil {\n        log.Fatal("加载 .env 文件错误:", err)\n    }\n\n    // 读取环境变量\n    appName := os.Getenv("APP_NAME")\n    dbHost := os.Getenv("DB_HOST")\n    dbPort := os.Getenv("DB_PORT")\n    dbUser := os.Getenv("DB_USER")\n    dbPassword := os.Getenv("DB_PASSWORD")\n\n    fmt.Printf("应用程序: %s\\n", appName)\n    fmt.Printf("数据库: %s:%s\\n", dbHost, dbPort)\n    fmt.Printf("用户: %s\\n", dbUser)\n    fmt.Printf("密码: %s\\n", dbPassword)\n}\n

\n\n

运行程序：

\n\n