F5调试前必须配置.launch.json文件，首次按F5会引导选择环境并自动生成；断点需设在可执行语句上，F10跳过函数、F11进入函数；调试控制台（Ctrl+Shift+Y）支持实时表达式求值。

F5 启动调试前必须有 launch.json

直接按 F5 不会“自动运行任意代码”，VSCode 需要明确知道用什么环境、怎么启动、加载哪些参数。这些信息存在项目根目录下的 .vscode/launch.json 中。

常见错误现象：无法启动调试 提示反复出现，不是快捷键坏了，而是根本没生成配置文件。

• 第一次按 F5，VSCode 会弹窗让你选环境（如 Python、Node.js、C#），选完就自动生成基础 launch.json
• 如果项目里有多个入口文件（比如多个 main.py 或 index.js），VSCode 可能默认选错；得手动改 launch.json 里的 program 或 module 字段
• TypeScript 项目必须确保已编译出 .js 文件，或在 launch.json 中加 "preLaunchTask": "tsc: build - tsconfig.json"，否则断点不命中

F9 设置断点是调试的起点

没有断点，F5 启动后程序会直接跑完，跟普通运行没区别。断点决定“在哪停”，是调试控制链的第一环。

• 把光标移到某行，按 F9，行号左侧出现红点即设好；再按一次取消
• 断点只能设在可执行语句上，比如 console.log()、if、return 行，不能设在空行或注释行
• 函数定义行（如 function foo() {）设断点，实际停在函数体第一行，不是定义本身

F10 和 F11 控制单步执行流

F10 和 F11 只在调试已启动且当前处于暂停状态时才有效——它们不是全局快捷键，而是“调试会话内专用指令”。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• F10（Step Over）：执行当前行，遇到函数调用不进去，直接跳到下一行
• F11（Step Into）：遇到函数调用就钻进去，光标跳转到被调函数第一行；但如果函数来自 node_modules 或压缩代码，默认会被跳过——需检查 launch.json 中是否配置了 "skipFiles"
• 两者都依赖源码映射准确；比如 Python 用 debugpy、Node.js 用 sourceMaps: true，否则可能跳到生成代码而非原始文件

调试面板和控制台切换比想象中重要

很多人卡在“看到变量值太慢”，其实不是断点没设对，而是没用对面板切换方式。

• Ctrl+Shift+Y（Win/Linux）或 Cmd+Shift+Y（macOS）：快速显示/隐藏「调试控制台」，里面能直接输入表达式（如 user.name）实时取值，比 hover 更快更准
• Ctrl+`：切换集成终端显隐；注意它只是显隐，不是新建实例；需要多任务并行（比如一边 npm run dev，一边 curl 测试）时，用 Ctrl+Shift+` 新建 shell 标签页
• 调试控制台输出和 console.log 是分开的；有些日志只出现在终端，有些只在调试控制台，别只盯一个地方

调试真正卡住的地方，往往不是快捷键记不住，而是 launch.json 配置和断点位置之间的错位——比如 TypeScript 没编译就设断点，或者 Python 脚本路径写成绝对路径导致找不到文件。这些细节不报错，但让断点完全失效。