VSCode稳定版无法自动加载.env环境变量，Insider版正常，求原因与方案

问题场景 #

Windows系统下，项目结构如下：

• venv
• .env
• test_load_env.py

.env文件内容：

PYTHONPATH=.
MY_USERNAME=myusername
MY_PASSWORD=mypass

test_load_env.py内容：

import os

username = os.environ.get("MY_USERNAME")
password = os.environ.get("MY_PASSWORD")
print(f"username: {username}, password: {password}")
print(os.environ.get("PYTHONPATH"))

版本差异现象 #

• VSCode 1.84.2（稳定版）：直接运行脚本时，返回结果显示.env未加载，即使在settings.json中添加"python.envFile": "${workspaceFolder}/.env"也无效；但调试模式下可正常加载环境变量。
• VSCode Insiders 1.85.0：无需调试或修改设置，直接运行脚本即可正常加载.env中的环境变量，且两者设置完全一致。

差异原因 #

VSCode Python扩展在1.85版本（Insiders先行推送）中更新了功能：新增了直接运行脚本场景下自动加载.env文件的逻辑。而1.84稳定版的Python扩展仅在调试模式下触发.env加载流程，直接运行（非调试）的场景并未集成该逻辑，因此即使配置了python.envFile也不会生效。

稳定版（1.84.2）替代解决方案（除python-dotenv外） #

1. 自定义运行任务（tasks.json） #

在项目根目录创建.vscode/tasks.json，手动配置加载环境变量后再执行脚本：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run Script with Env",
            "type": "shell",
            // PowerShell命令示例，按需调整为CMD语法
            "command": "$env:PYTHONPATH='.'; $env:MY_USERNAME='myusername'; $env:MY_PASSWORD='mypass'; python test_load_env.py",
            "group": {
                "kind": "test",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}

配置完成后，通过「终端→运行任务」选择该任务即可加载环境变量运行脚本。

2. 终端手动加载环境变量再运行 #

• CMD终端：

  set PYTHONPATH=.
  set MY_USERNAME=myusername
  set MY_PASSWORD=mypass
  python test_load_env.py
  

• PowerShell终端：

  $env:PYTHONPATH='.'
  $env:MY_USERNAME='myusername'
  $env:MY_PASSWORD='mypass'
  python test_load_env.py
  

也可以把这些命令保存成.bat（CMD）或.ps1（PowerShell）脚本，每次运行脚本前先执行该批处理。

3. 利用Python扩展的实验性开关（可选） #

检查1.84稳定版Python扩展的设置，是否存在Python > Experiments: Enable Env File Loading For Run这类实验性开关，若有则开启后尝试直接运行脚本（注：该开关可能仅在特定预览版本中存在，不一定适用于1.84正式版）。

内容的提问来源于stack exchange，提问作者RA-LBR