调试中断时应直接在断点处执行process.argv.slice(2)查看传入参数，或console.log(process.env)检查环境变量；实际生效的环境变量仅来自launch.json中env字段或系统PATH，不继承shell配置。
调试中断时怎么看实际生效的环境变量
VSCode 调试器启动的 Node 进程，环境变量不等于你终端里 echo $PATH 的结果，也不继承 .zshrc 里所有 export——它只认 launch.json 里显式声明的 env 字段，或系统 PATH 中能被 runtimeExecutable 找到的部分。
最直接的办法是在断点处加一行：console.log(process.env)，但更稳妥的是用 process.execPath 和 process.env.PATH 分别确认：运行时用的是哪个 node、PATH 是不是含你期望的 bin 目录。
- 如果
process.env.NODE_ENV是undefined，说明 launch.json 没配env，别指望靠.env文件自动加载 - macOS/Linux 用户在
env里写PATH时，记得把${env:PATH}放在末尾，否则可能覆盖掉系统关键路径 - Windows 用户注意斜杠方向：
"PATH": "C:/nodejs;C:/Users/me/AppData/Roaming/npm;${env:PATH}"，反斜杠会解析失败
launch.json 里 program 和 args 怎么写才不会错
program 必须是可执行的 JS 文件绝对路径，${workspaceFolder}/index.js 是安全写法；写成 ./index.js 或 index.js 会因工作目录不确定而失败。Node 调试器不解析相对路径，也不 fallback 到 package.json#main。
args 是传给脚本的参数数组，不是 shell 命令行字符串。比如想等效于 node index.js --port=3000 --debug，就得写："args": ["--port=3000", "--debug"]，中间不能带空格拼接。
- 如果脚本依赖
process.argv[2]，确保args至少有 2 个元素，否则下标越界 - 含空格的参数（如
--name="my app"）必须整个作为单个字符串，不要拆开 - TypeScript 项目别把
program指向.ts文件，除非你用了runtimeExecutable: "npx"+runtimeArgs: ["ts-node", "src/index.ts"]
为什么断点停住后 process.env 里没有我设的变量
常见原因是 launch.json 配置被覆盖：比如你改了全局 settings.json 里的 terminal.integrated.env.*，但它只影响终端，不影响调试器进程；或者你在多个配置里用了相同 name，VSCode 实际加载了另一个没改的配置。
检查方法：打开“运行和调试”面板，确认顶部选中的配置名和你编辑的 launch.json 里一致；再点右上角齿轮图标，看弹出的 JSON 是否真包含你写的 env 字段。
- 如果用了
preLaunchTask，它的输出环境变量不会透传给调试进程，得在env里重复声明 - 远程调试（SSH）时，
env里写的路径必须是远程服务器上的真实路径，本地路径无效 - 某些插件（如 REST Client）会注入自己的 env，干扰调试器，临时禁用可验证是否冲突
调试中断时怎么快速验证参数是否传进来了
别靠猜，直接在断点第一行加 console.log('argv:', process.argv)，对比终端执行 node index.js --x=1 的输出。你会发现调试器启动时 process.argv[0] 是 node 路径，[1] 是脚本路径，[2] 开始才是你的 args。
更省事的是在调试控制台里输入：process.argv.slice(2)，它会立刻返回你配置的 args 数组内容，连格式都不用处理。
- 如果
process.argv.length ，说明args没生效，优先检查 launch.json 语法是否合法（逗号、引号、括号） - Node --inspect 参数塞进
argv，可能挤占你的参数位置，升级版本可避免混淆 - 使用
runtimeExecutable启动 npm 或 yarn 时，args是传给 npm 的，不是传给脚本的，得改用runtimeArgs并确保 script 里正确转发
调试器从不自动读取你 shell 里的环境变量，也不理解 package.json 脚本逻辑。每个 env、每条 args、每个 program 路径，都得明明白白写进 launch.json——漏一个字符，就可能让断点停在错误的地方，或让变量始终是 undefined。
