vscode本身不注入环境变量，所有生效方式都依赖运行代码的工具链；它不会自动解析或转发.env文件内容，真正起作用的是dotenv加载、cross-env注入、source命令或launch.json中的env/envfile字段。
VSCode 本身不注入环境变量，所有生效方式都依赖你运行代码所用的工具链 —— 直接改 .env 文件或编辑器设置，对 node、python、yarn 等进程完全无效。
为什么 console.log(process.env.MY_VAR) 总是 undefined
常见错误现象包括：process.env 读不到 .env 里的值、终端 echo $MY_VAR 为空、调试器里变量未出现。根本原因是：VSCode 是编辑器，不是运行时环境；它不会自动解析或转发 .env 文件内容。
真正起作用的是：
- 你的运行命令是否显式加载了 dotenv（如
node -r dotenv/config index.js dotenv_config_path=.env） - Python 是否调用了
load_dotenv()（且路径正确） -
yarn或npm脚本是否通过cross-env或 shell 层面注入（如cross-env NODE_ENV=dev yarn start） - 终端启动时是否已
source .env（需手动或借助direnv）
launch.json 中的 env 和 envFile 怎么用
envFile 只被 Node.js 和 Python 调试器稳定支持，且仅影响单次调试进程，不改变终端或外部命令行为。
实操建议：
-
envFile必须写相对路径，推荐用${workspaceFolder}/.env，不要用~或绝对路径 - 若需多文件（如
.env+.env.local），envFile不支持合并，得手动 cat 合并或换用插件 -
env字段可硬编码变量，优先级高于envFile，适合覆盖敏感值（如"API_KEY": "test-only"） - Go/Rust/C++ 调试器通常不支持
envFile，只能靠env字段逐个写死
示例（Node.js 调试配置）：
{
"type": "node",
"request": "launch",
"name": "Launch with env",
"program": "${workspaceFolder}/index.js",
"envFile": "${workspaceFolder}/.env",
"env": {
"NODE_ENV": "development"
}
}
终端里让 .env 生效的可靠方法
VSCode 内置终端（bash/zsh/powershell）和 VSCode 完全解耦，不会自动 source .env。别指望设置里勾个选项就搞定。
可行方案：
- 手动执行：
source .env（注意：只对当前终端 Tab 有效） - 在 shell 配置文件中加判断逻辑（如
~/.zshrc末尾）：[[ -f .env ]] && set -o allexport && source .env && set +o allexport - 用
direnv（推荐）：安装后在项目根目录运行direnv allow，它会自动检测并加载.env，退出目录时自动清理 - Windows PowerShell 用户可用
dotnet-env或自定义脚本，但原生支持弱于 Unix-like 系统
远程开发（SSH/WSL）时环境变量怎么传
远程场景下，本地 .env 对远程进程完全不可见。系统级变量（/etc/environment）、用户 shell 配置（~/.bashrc）和 launch.json 的 env 字段是三大来源，优先级依次升高。
关键点：
-
launch.json中的env字段只作用于调试进程，不影响远程终端里手动运行的python app.py - 若用
yarn dev启动服务，必须确保该命令在远程 shell 中能读到变量 —— 这取决于你是否把.env加入了~/.bashrc或用了direnv - WSL 用户注意：Windows 的
Path不自动透传到 WSL，Anaconda 环境变量需在~/.bashrc里显式export
最简验证法：在远程终端执行 printenv | grep MY_VAR，有输出才说明环境真就绪了。
容易被忽略的一点：很多框架（如 Next.js、Create React App）只在启动时读取环境变量，改了 .env 必须重启 dev server 才生效 —— 这跟 VSCode 无关，但常被误认为是配置失败。
