如何在VS Code中结合Docker与.NET 7设置并读取环境变量

问题分析 #

你遇到的核心问题是：使用【Docker .NET Launch】启动时，容器未正确加载配置的环境变量，导致Environment.GetEnvironmentVariable("FOO")返回null。这通常和启动配置关联、环境变量大小写敏感、配置优先级这几个因素有关。

解决方案 #

1. 确保启动配置关联Docker Compose文件

检查.vscode/launch.json中的【Docker .NET Launch】配置，确认它绑定了docker-compose.debug.yml，而不是仅使用单独的docker-run任务。正确的配置示例：

{
    "name": "Docker .NET Launch",
    "type": "docker",
    "request": "launch",
    "preLaunchTask": "docker-run: debug",
    "netCore": {
        "appProject": "${workspaceFolder}/Kno2.WebSockets.csproj"
    },
    "dockerCompose": {
        "file": "docker-compose.debug.yml",
        "service": "myservice",
        "command": "start-debug"
    }
}

如果启动配置未关联docker-compose.debug.yml，会直接忽略该文件中的environment配置项。

2. 统一环境变量大小写

Linux/Docker环境下环境变量大小写敏感，必须保证配置名称和读取名称完全一致：

• docker-compose.debug.yml中保持FOO=foo
• tasks.json中把"foo": "bar"修改为"FOO": "bar"
• 代码中Environment.GetEnvironmentVariable("FOO")保持不变

3. 验证容器环境变量是否注入成功

启动容器后，用以下命令确认环境变量是否已正确加载：

# 获取运行中容器ID
docker ps
# 进入容器查看所有环境变量
docker exec -it <容器ID> env

如果输出中没有FOO，说明启动流程未正确加载配置文件，需重新检查launch.json和docker-compose的关联关系。

4. 避免配置冲突

若同时在tasks.json和docker-compose.debug.yml中配置了同一环境变量，docker-compose的配置优先级更高，但前提是启动时确实使用了docker-compose流程。如果启动配置用的是单独docker-run任务，只会读取tasks.json中的env配置。

调试小技巧 #

可以在Program.cs中打印所有环境变量，快速排查问题：

foreach (DictionaryEntry envVar in Environment.GetEnvironmentVariables())
{
    Console.WriteLine($"{envVar.Key}: {envVar.Value}");
}

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