VSCode本身不读取、不注入、也不自动加载.env文件中的变量，所有“没生效”问题根源在于此；真正起作用的是运行工具（如node、python）是否调用dotenv等库显式加载，调试需在launch.json中配置envFile，终端需借助direnv或手动source，代码中须显式调用dotenv.config()或load_dotenv()才生效。
VSCode 本身不加载、不注入、也不自动读取 .env 文件里的变量——所有“没生效”的问题，根源都在这里。
为什么改了 .env 却 console.log(process.env.XXX) 是 undefined
VSCode 是编辑器，不是运行时。它不会把 .env 里的内容塞进 process.env，也不会影响终端 shell 的环境。真正决定变量是否可用的，是你的运行命令（比如 node index.js 或 python app.py）有没有调用对应语言的加载库。
- Node.js 项目必须在代码开头显式写
require('dotenv').config()或import 'dotenv/config' - Python 项目得调用
load_dotenv()（来自python-dotenv），且通常要放在import之前 - 如果你直接在终端里跑
node index.js，但没装dotenv包或没调用它，.env就纯属文本文件 - VSCode 调试器（
launch.json）和终端是两个独立环境：一个配了envFile，另一个照样看不到变量
如何让 launch.json 调试时读到 .env 变量
VSCode 的调试器支持通过 envFile 字段加载 .env，但它只对当前调试进程生效，且仅限部分语言插件（Node.js、Python 稳定；Go/Rust 不一定支持）。
-
.env文件必须放在工作区根目录，或用相对路径明确指定，例如："envFile": "${workspaceFolder}/.env" - 配置示例（Node.js）：
{ "type": "node", "request": "launch", "name": "Launch with .env", "program": "${workspaceFolder}/index.js", "envFile": "${workspaceFolder}/.env" } -
envFile不会自动合并.env.local或.env.development；需要多文件时，要么手动合并，要么改用dotenv-flow等库 - 该字段不影响终端、不触发 IntelliSense 补全、也不改变你代码里是否需要调用
dotenv.config()
DotENV 插件只管高亮，不管运行
装了 DotENV 插件却没颜色？大概率是 VSCode 没把它当环境变量文件识别。插件只负责语法着色和基础补全，跟变量是否生效毫无关系。
- 打开
.env文件后，点右下角的Plain Text，选Environment或dotenv（取决于插件注册名） - 想让
.env.local、docker.env也高亮，得在settings.json里加："files.associations": { "*.env*": "dotenv", "*env*": "dotenv" } - 首选插件是
DotENV（作者 mikestead），图标是绿色圆点；别装dotenv syntax（已弃用）或名字带 “for React” 的限定型插件 - 高亮正常但值错位？检查文件编码：Windows 记事本保存的
.env常带 UTF-8 BOM 头，VSCode 解析会偏移，删掉 BOM 或用 VSCode 自带“重新以编码保存”功能转为无 BOM UTF-8
终端里怎么让 .env 生效
VSCode 内置终端就是个 shell（bash/zsh/powershell），它和编辑器完全解耦。VSCode 不会帮你 source .env，也不能靠插件自动完成。
- 手动执行：
source .env（Linux/macOS）或Get-Content .env | ForEach-Object { $env:$_.Split('=')[0] = $_.Split('=')[1] }（PowerShell） - 长期方案：用
direnv（推荐），它会在进入目录时自动source .env，离开时自动清理，且支持.env.local覆盖逻辑 - 别在
~/.zshrc里全局source项目级.env——容易污染其他项目，也违背环境隔离原则 - 注意：
echo $API_URL在终端里为空，不代表代码里不能用——只要你的 Node/Python 进程自己加载了.env，就和终端环境无关
最易被忽略的一点：环境变量加载顺序和优先级。系统级变量、shell 启动脚本设的、launch.json 的 env 字段、envFile、代码中 process.env.XXX = 'xxx' ——它们层层覆盖，而 dotenv 默认不覆盖已存在的变量。调试时若发现值不对，先查 process.env 初始状态，再看哪一层动了手。
