调试控制台仅支持当前栈帧内已存在变量和方法的读取与无副作用调用,不执行import、多行语句或定义新函数;可选链、typeof、watch面板和setexpression等能力需按边界谨慎使用。

调试控制台里直接输变量名就能看值
断点停住后,打开“调试控制台”(Debug Console),输入 user 或 items.length 这类简单表达式,回车就出结果。它不是终端,不执行 import、不支持多行、也不能定义新函数——只读取当前栈帧里已存在的变量和方法。
常见错误现象:输 print(x) 报错、输 if (x > 0) { ... } 直接 SyntaxError、输 import os 提示 ReferenceError。这些都不是控制台的设计目标。
- 变量名含空格或特殊字符?用
locals()['my var']访问 - 嵌套对象属性太深?直接输
response.data.users[0].name,支持链式访问 - 想确认变量是否存在但怕报错?用
typeof data === 'undefined'或data?.length(可选链)
调用无副作用方法快速验证逻辑
控制台允许你调用当前作用域下已定义的对象方法,比如 array.filter(x => x > 5)、user.getName(),前提是这些方法不修改状态、不发请求、不触发 DOM 更新。
为什么这样做?比打断点+单步更轻量,尤其适合检查过滤条件是否写错、格式化函数返回是否符合预期。但它不会重执行整个函数体,只是“快照式调用”。
- 避免调用
saveToDB()、toggleLoading()这类有副作用的方法,否则可能让后续断点行为异常 - 异步函数(
async)不能直接调用,会提示RuntimeWarning: coroutine 'xxx' was never awaited - Python 用户注意:
debugpy默认禁用exec,所以eval("1+1")会失败,别试
用监视(Watch)面板持续跟踪表达式变化
“监视”区域比控制台更适合长期观察——每次断点命中都会自动刷新值,不用反复敲。点击“+”号添加如 config.settings.theme.darkMode 或 calculateTotal(items) 这类表达式。
它不依赖变量是否在当前作用域显式声明,只要能在当前调用栈中解析出来就行。比如你在 handleClick 里暂停,却可以监视 props.user.id,只要该 props 是上层传入且未被优化掉。
- 多个环境切换时,建议给监视项加前缀,比如
dev_api_url和prod_api_url,避免混淆 - 监视表达式不修改代码,也不影响执行流,比日志断点更干净
- 深层嵌套访问(如
data?.items?.[0]?.meta?.score)一旦某层为null就整个显示undefined,不如用可选链提前兜底
setExpression 修改变量值要小心生效时机
VS Code 的 Chrome 调试器(以及部分 Python/Go 调试器)支持 setExpression 命令临时改值,例如在控制台输 setExpression "count" "100"。底层其实是拼成 count = 100 再执行赋值。
但关键点在于:这个修改**不会立刻更新变量面板里的显示**,也不会回写到寄存器或堆内存的原始位置——它只作用于当前帧的求值上下文。必须继续执行(F5)或单步(F10/F11)后,新值才真正参与后续逻辑。
- 不要指望改完
userId后立刻看到 API 请求 URL 变化,除非那行请求代码还没执行 - 对 const 声明的变量尝试修改,会静默失败(无报错,但值不变)
- Go 用户注意:Delve 的
set命令更底层,但 VS Code 的setExpression在 Go 中支持有限,优先用变量面板右键“设置值”
user.name = 'test' 就改了,其实只是这次求值返回了字符串,原对象可能压根没变。得看清上下文,才能用得稳。











