VSCode Python扩展envFile参数失效，如何加载指定位置.env文件？

我正在配置基于FastAPI的Python项目，需要从非默认位置读取.env环境变量文件。已在VSCode的工作区及用户级settings.json、launch.json中配置指定路径，但vscode-python扩展始终无法加载目标.env文件，怀疑是该扩展的已知Bug（相关GitHub线程中此问题长期未明确修复）。

已尝试的配置 #

settings.json（工作区及用户级） #

{
    [...]
    "python.envFile": "${workspaceFolder}/.env-DEV"
    [...]
}

launch.json #

{
    "version": "0.2.0",
    "configurations": [
        {
            [...]
            "envFile": "${workspaceFolder}/.env-DEV",
            [...]
        }
    ]
}

解决方法与替代方案 #

1. 代码内手动加载.env文件 #

直接在项目入口（如main.py）用python-dotenv库手动加载指定路径的.env文件，绕过VSCode扩展限制：

from dotenv import load_dotenv
import os

# 加载指定路径的.env文件
load_dotenv(dotenv_path=os.path.join(os.getcwd(), ".env-DEV"))

from fastapi import FastAPI

app = FastAPI()

# 通过os.getenv("YOUR_VAR_NAME")获取环境变量

先安装依赖：

pip install python-dotenv

2. 用VSCode任务启动项目 #

创建.vscode/tasks.json，通过shell命令加载.env后启动FastAPI：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "start-fastapi-dev",
            "type": "shell",
            "command": "set -a && source .env-DEV && uvicorn main:app --reload",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}

Windows环境下替换命令为：

cmd /c "call .env-DEV && uvicorn main:app --reload"

按下Ctrl+Shift+B即可执行任务启动项目。

3. 验证路径配置正确性 #

• 打开VSCode命令面板（Ctrl+Shift+P），执行Python: Show Environment Variables，检查是否包含目标.env里的变量。
• 尝试用绝对路径替换${workspaceFolder}，比如/your/project/path/.env-DEV（Linux/macOS）或C:\your\project\path\.env-DEV（Windows），排除变量解析故障。

4. 重置VSCode扩展缓存 #

关闭VSCode后删除以下缓存目录，再重启VSCode加载项目：

• Linux: ~/.config/Code/Cache、~/.config/Code/CachedData
• macOS: ~/Library/Caches/Code、~/Library/Application Support/Code/CachedData
• Windows: %APPDATA%\Code\Cache、%APPDATA%\Code\CachedData

内容的提问来源于stack exchange，提问作者Eduardo Lúcio