VS Code 调试控制台怎样执行多行表达式

VS Code 的 Debug Console 是当前调试会话里的 REPL，可以在选中的栈帧上下文中临时求值。要执行多行表达式，关键是：打开调试控制台后，用 Shift+Enter 换行，确认表达式完整后再按 Enter 提交。直接按 Enter 会提前执行当前输入。

官方地址：https://code.visualstudio.com/docs/debugtest/debugging

本文使用原创界面说明图演示入口和输入状态，不是 VS Code 实际运行截图。

先让调试会话停下来

先打开项目中的源文件，在可执行代码行左侧设置断点，然后按 F5 启动调试。程序停住后，Run and Debug 视图会显示当前会话的调用栈和变量信息。只有存在活动调试会话时，Debug Console 才有可用的求值上下文。

可以从菜单选择 View: Debug Console，也可以使用命令面板搜索同名命令。打开后，重点确认底部面板确实属于当前暂停的会话，而不是普通终端。

用 Shift+Enter 输入多行表达式

在 Debug Console 输入区域先写第一行，不要急着按 Enter。需要继续换行时按 Shift+Enter，光标会留在同一个输入块中，可以继续补齐属性访问、条件判断或临时计算。

// 中文注释：示例表达式只用于说明多行输入，不代表某个项目的真实变量
const current = {
  name: user.name,
  enabled: user.profile?.enabled
};
current.enabled;

上面的内容应作为一个完整输入块处理。不同调试器对表达式语法的支持不同，因此示例中的可选链、临时变量或语句块是否可执行，要以当前语言调试器的实现为准。

按 Enter 执行并看当前上下文

确认输入完整后按 Enter，Debug Console 会在当前选中的栈帧上下文中求值，并将返回值或错误信息显示在结果区域。若你先在 CALL STACK 中切换了栈帧，再执行同一表达式，能够访问的局部变量可能随之变化。

临时计算适合查看对象属性、验证条件和快速比较值，不会自动把修改写回源代码。涉及副作用的表达式仍应谨慎执行，尤其是会改变程序状态、触发请求或写入数据的调用。

多行输入不生效时怎么排查

1. 没有输入区域：确认当前已经启动并暂停调试，而不是只打开了普通终端。
2. 按 Shift+Enter 仍然报错：检查是否真的在 Debug Console 输入框中获得焦点，并确认没有切换到终端面板。
3. 表达式无法求值：检查当前栈帧是否包含所需变量；表达式语法和求值能力取决于调试器扩展。
4. 结果与预期不同：先在 CALL STACK 中选择正确栈帧，再重新执行，不要把旧结果当成当前帧结果。

小结

记住三个动作即可：先启动并暂停调试，接着打开 Debug Console，用 Shift+Enter 组织多行输入，最后按 Enter 求值。若操作路径正确但语法仍不支持，优先查看当前调试器的表达式能力，而不是反复修改快捷键。

常见问题

Debug Console 和集成终端有什么区别？

Debug Console 面向活动调试会话，可以访问选中栈帧中的调试上下文；集成终端执行的是 Shell 命令，不能直接替代调试器的表达式求值。

为什么按 Enter 后多行内容提前执行？

在 Debug Console 中，Enter 是提交并求值动作。需要继续输入时使用 Shift+Enter，完成全部内容后再按 Enter。