vscode中环境变量无真正“持久化存储”，关键在于每次启动时稳定加载；唯一可靠方式是通过terminal.integrated.env.*注入path及node_options等变量，并彻底重启vscode生效。
VSCode 里配置 Node.js 环境变量的“持久化存储”，其实是个常见误解——环境变量本身不持久，真正能持久的是你让它们生效的方式。关键不是存到哪，而是每次启动终端或调试器时，都能稳定加载。
terminal.integrated.env.* 是唯一可靠入口
VSCode 不继承 GUI 启动时的 shell 配置（比如 ~/.zshrc），所以靠改 shell 文件无法保证每次生效。必须用 VSCode 自己的环境变量注入机制：terminal.integrated.env.windows（Windows）、terminal.integrated.env.linux（Linux）或 terminal.integrated.env.osx（macOS）。
- 全局配置写在 VSCode Settings（
settings.json）里；局部配置写在项目根目录.vscode/settings.json中 - 路径必须是
node.exe所在目录（如C:/Program Files/nodejs），不是node_modules或安装包压缩包路径 - 务必保留
${env:PATH}，否则会丢掉npm、git等命令 - Windows 路径用正斜杠
/或双反斜杠\，单反斜杠会被 JSON 解析报错
调试器 runtimeExecutable 和终端 PATH 不互通
即使 node -v 在终端里跑通了，launch.json 仍可能报 Cannot find runtime 'node'。这是因为调试器默认不查系统 PATH，尤其当你用了 nvm、fnm 或手动指定版本时。
Wjs Localizing Video
下载
用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
- 在
.vscode/launch.json中显式写死runtimeExecutable，例如："runtimeExecutable": "C:/Program Files/nodejs/node.exe" - 如果项目用
nvm管理多版本，不要用~/.nvm/versions/node/v18.17.0/bin/node这种路径——它可能随nvm use变动，且 VSCode 启动时不执行nvm初始化 -
runtimeExecutable的路径必须可执行，且权限正常（Linux/macOS 下需有x权限）
NODE_OPTIONS 和 --max-old-space-size 这类参数不能靠 .env 注入
.env 文件只对运行时进程有效（比如 node index.js 启动后读取），但 VSCode 终端本身、调试器启动前的 Node 进程、甚至 npm 命令本身，都不自动加载它。要让 --max-old-space-size=4096 生效，必须走环境变量注入。
- 在
terminal.integrated.env.*中添加："NODE_OPTIONS": "--max-old-space-size=4096" - 不要写成
"NODE_OPTIONS": "-max-old-space-size=4096"（漏了双横线） - 该设置只影响 VSCode 终端里启动的 Node 进程，不影响外部终端或系统级 Node
- 若同时设了
NODE_ENV=production，注意它会影响某些库（如 Express）的行为，默认不打印详细错误
最容易被忽略的一点：所有环境变量相关修改，都必须彻底关闭并重启 VSCode（不是重载窗口），否则进程环境不会刷新。尤其是 macOS/Linux 用户，从 Dock 启动的 VSCode 永远不会重新加载 ~/.zshrc，哪怕你改了十次也白搭。
