VSCode开发环境搭建：如何调用Node.js全局变量

直接给出结论：VSCode 调试器本身并不会主动“调用”全局变量，它只是让你在调试过程中查看、修改以及通过表达式来访问全局变量（如 globalThis、process、global、window（仅 Electron 环境））。能否成功操作，取决于你当前断点是否停留在可访问该变量的作用域、该变量是否被引擎优化掉、以及 Node.js 运行时是否允许写入。

为什么在 Debug Console 中输入 globalThis.myFlag 没有反应？

常见现象是：输入后按下回车，控制台没有输出也没有报错，变量值也未改变——背后的原因往往不是语法错误，而是执行上下文或可写性限制在作祟：

• globalThis.myFlag 仅执行读取操作，没有赋值自然不会改变值；要修改必须执行 globalThis.myFlag = true
• 如果 myFlag 不存在，赋值会创建它；但如果目标属性是通过 Object.defineProperty(globalThis, 'myFlag', { writable: false }) 定义的，就会静默失败（Node.js 中极少这样设置，但第三方库可能会）
• 在 Node.js 调试中，process.env 是一个只读副本，直接执行 process.env.NODE_ENV = 'test' 不会生效，必须修改 launch.json 中的 env 字段并重启调试会话
• 某些变量（如 __filename、__dirname）是模块级常量，无法在 Debug Console 中重新赋值

如何在 Debug Console 中安全地修改全局变量？

关键不是“能不能输入”，而是“在哪里输入、输入什么、有没有副作用”——

• 断点必须停留在能够访问全局对象的上下文环境中，例如入口文件顶部或 setTimeout 回调中。虽然 globalThis 在任何地方都可访问，但作用域链并不会影响它，不过你最好确认自己确实停在了正确的位置。
• 优先使用 globalThis 而不是 global 或 window：前者是标准跨环境全局对象，Node.js 和现代浏览器均支持；global 在 Node.js 中存在但不推荐使用；window 在纯 Node.js 环境中为 undefined。
• 修改前先确认对象是否存在：使用 globalThis?.config 再赋值，避免出现 Cannot set property 'xxx' of undefined 错误。
• 对于使用 const 声明的顶层变量（例如 const API_URL = ''），在 Debug Console 中直接赋值会报错。可以尝试使用 eval("API_URL = 'new-url'")（仅限 Node.js 调试，且调试器需启用 eval 支持，默认情况下是开启的）。

为什么 Variables 面板中看不到 process 或 globalThis？

Variables 面板默认只显示当前作用域内的局部变量和闭包变量，process、globalThis 这类全局对象不会自动展开。但它们完全可以在 Debug Console 中发挥作用：

• 在 Debug Console 中输入 Object.keys(globalThis) 可以列出所有全局属性（包括 process、console、require 等）。
• 输入 process.argv 或 process.pid 可以即时查看运行时参数和进程 ID。
• 想要监控变化？可以在 Watch 面板中添加表达式：globalThis.DEBUG_MODE 或 process.memoryUsage().heapUsed。
• 注意：某些属性（例如 process.env）在 Variables 面板中显示为只读对象，但在 Debug Console 中仍可通过 process.env 对象本身进行读取，只是无法修改。

真正容易被忽略的要点是：修改全局变量仅在当前调试会话的生命周期内有效，重启调试后变量值会还原；并且无法影响已加载模块的缓存行为（例如修改了 globalThis.IS_DEV，但某个模块在启动时已经根据旧值执行了分支逻辑，那部分代码不会重新执行）。