如何在VS Code开发容器中访问zsh环境变量？

环境配置详情 #

本地zsh的.zshrc配置 #

...
export SOME_API_KEY=XXXXXXXXXXXXXXX
...

Dev Container的devcontainer.json配置 #

{
    "name": "Python 3",
    "image": "mcr.microsoft.com/devcontainers/python:3.11",
    "containerEnv": {
        "SOME_API_KEY": "${localEnv:SOME_API_KEY}"
    }
}

测试用Python代码（main.py） #

...
print(os.environ['SOME_API_KEY'])
...

问题现象 #

重新构建容器并运行上述脚本后，抛出环境变量不存在的错误：

Traceback (most recent call last):
File "/workspaces/supreme-rat/main.py", line 21, in <module>
print(os.environ['SOME_API_KEY'])
~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^
File "<frozen os>", line 678, in __getitem__
KeyError: 'SOME_API_KEY'

解决思路与步骤 #

1. 修正本地环境变量加载逻辑 #

.zshrc仅在交互式shell会话中加载，如果VS Code是通过GUI图标启动的，它不会读取.zshrc中的环境变量。可以：

• 将环境变量移至~/.zshenv文件（所有zsh会话，包括非交互式场景都会加载）；
• 从zsh终端中执行code .启动VS Code，确保环境变量已加载到VS Code的进程环境中。

2. 确保容器构建时的变量传递 #

先在本地终端执行echo $SOME_API_KEY，确认变量确实存在。然后完全重建Dev Container（不是简单重启），确保扩展在构建阶段读取到最新的本地环境变量。

3. 备选方案：使用.env文件 #

如果不想修改shell配置，可在项目根目录创建.env文件：

SOME_API_KEY=XXXXXXXXXXXXXXX

然后通过python-dotenv库读取：

from dotenv import load_dotenv
load_dotenv()
print(os.environ['SOME_API_KEY'])

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