VSCode没有“环境变量映射表”设置项,因其根本不存在;实际需通过.python.envFile指定.env文件路径或在launch.json的env字段中显式配置键值对来注入环境变量。

VSCode 本身不提供“环境变量映射表”这种抽象配置机制;你真正需要的是让 Python 进程(运行、调试、终端)加载指定的 .env 文件,或在 launch.json / settings.json 中显式注入键值对。
为什么找不到“环境变量映射表”设置项
VSCode 的 Python 扩展没有名为“环境变量映射表”的 UI 配置页或 setting key。所谓“映射”,实际是通过文件路径(.env)或 JSON 字段(env)把变量名 → 值的对应关系传递给 Python 进程。如果你在设置里搜不到这个词,不是漏装插件,而是它根本不存在。
常见错误现象:在设置里搜索 “env map”、“variable mapping” 或 “environment table”,结果为空;或误以为 python.envFile 是个可视化表格编辑器——它只是个路径字符串。
python.envFile 指向 .env 文件(推荐用于项目级变量)
这是最接近“映射表”的做法:用纯文本文件定义变量名和值,VSCode + Python 扩展会在启动解释器时自动加载。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能,主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ,专为学生、算法学习者和开发者设计;✅ 一个技能,两种用途 :;核心要点📝 题解模式 :输入题目/题号,自动生成完整 Python 题解(含详细注释、解题思路、复杂度分析);💬 注释模式 :输入 Python 代码,自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记(深入)”;
- 在项目根目录创建
.env文件(注意无后缀,不是.env.txt) - 写入形如
API_KEY=sk-xxx、DATABASE_URL=sqlite:///db.sqlite3的行,**等号两侧不能有空格** - 在
.vscode/settings.json中声明路径:"python.envFile": "${workspaceFolder}/.env" - 确保 Python 扩展已安装且启用;重启 VSCode 窗口(非标签页),否则
.env不生效 - 验证方式:写脚本
import os; print(os.getenv("API_KEY")),运行后应输出值
在 launch.json 中硬编码 env 字段(适合调试场景)
当你要为某个调试会话单独覆盖变量,或 .env 文件不被读取时,直接在调试配置里写死键值对更可靠。
- 在项目根目录建
.vscode/launch.json - 在
configurations数组中添加或修改条目,加入env字段:
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "pytest",
"env": {
"PYTHONPATH": "${workspaceFolder}/src",
"LOG_LEVEL": "DEBUG"
}
}
-
env是 JSON 对象,键必须是字符串,值可以是字符串或null(表示清除该变量) - 该配置仅作用于调试器启动的进程,不影响集成终端或普通运行
- 如果同时用了
python.envFile和env,后者会**覆盖前者同名变量**
容易被忽略的三个细节
python.envFile 路径必须是绝对路径或基于 ${workspaceFolder} 的相对路径,不能用 ~/ 或环境变量展开;.env 文件编码必须是 UTF-8 无 BOM;Windows 下路径分隔符用 / 或 \ 均可,但 在 JSON 里需转义为 \。
最常踩的坑:改完 .env 后没重启 VSCode 窗口,导致旧变量缓存仍在;或在 settings.json 里写了 python.envFile 却忘了创建对应文件,VSCode 不报错也不提示——它只是静默跳过加载。

















