如何在VS Code中调试Go代码并加载local.env配置文件？

1. 基础准备 #

确保你已经安装了VS Code官方的Go扩展，这是Go语言调试的核心依赖。

2. 配置launch.json加载local.env #

• 打开VS Code的「运行和调试」面板（快捷键：Ctrl+Shift+D），点击「创建launch.json文件」，选择Go环境生成基础配置。
• 在生成的launch.json中，给目标调试配置添加envFile字段，指定你的local.env文件路径。示例配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "启动Go程序",
            "type": "go",
            "request": "launch",
            "mode": "auto",
            "program": "${workspaceFolder}/cmd/main.go", // 替换为你的主程序入口路径
            "envFile": "${workspaceFolder}/local.env"     // local.env的实际路径，根目录下直接用这个即可
        }
    ]
}

注意：如果local.env在子目录中，比如config/local.env，则路径改为${workspaceFolder}/config/local.env。

3. 解决__debug_bin被自动删除的问题 #

这个现象通常是调试会话异常终止导致的，可通过以下方式排查修复：

• 检查local.env格式：确保文件每行都是KEY=VALUE的格式，值不需要额外加引号（除非你的代码逻辑明确要求），比如正确写法是DB_PORT=5432，而非DB_PORT="5432"。
• 验证program路径：确认launch.json中program字段指向的是正确的主程序入口文件，路径错误会导致调试无法正常启动，触发VS Code自动清理临时调试二进制文件。
• 手动编译调试二进制：打开终端，执行以下命令手动生成调试用的二进制文件：

go build -gcflags="all=-N -l" -o __debug_bin ./cmd/main.go

然后修改launch.json的program字段为${workspaceFolder}/__debug_bin，再启动调试，以此排查是编译配置问题还是VS Code自动生成的问题。

额外技巧 #

• 如果需要在local.env基础上添加临时环境变量，可以在launch.json中同时配置env字段，其中的变量会覆盖envFile中的同名变量：

"env": {
    "LOG_LEVEL": "debug"
},
"envFile": "${workspaceFolder}/local.env"

• 记得把local.env加入.gitignore，避免敏感配置提交到版本仓库。

内容的提问来源于stack exchange，提问作者Ashish Tripathi