VSCode如何管理环境变量？Dotenv插件使用【教程】-VSCode-PHP中文网

vscode本身不读取、不注入、也不自动加载.env文件中的变量，所有“没生效”问题根源在于此；真正起作用的是运行工具（如node、python）是否调用dotenv等库显式加载，调试需在launch.json中配置envfile，终端需借助direnv或手动source，代码中须显式调用dotenv.config()或load_dotenv()才生效。

vscode如何管理环境变量？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 不一定支持）。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

.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 初始状态，再看哪一层动了手。