VSCode调试需先配置launch.json，再在代码行左侧单击设断点；可快捷键切换启用状态，右键设条件或日志断点，调试中还可动态添加函数断点。
如果您在使用 VSCode 进行代码开发时希望暂停程序执行以检查变量状态或逻辑流程，则需要借助断点功能实现精准调试。以下是设置断点并启动调试的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、确认项目已配置调试环境
VSCode 本身不内置运行时，需依赖对应语言的调试器扩展及 launch.json 配置文件来识别调试入口。未配置时点击“运行”侧边栏的“开始调试”按钮将提示缺失配置。
1、打开项目根目录下的 .vscode 文件夹，检查是否存在 launch.json 文件。
2、若不存在，点击左侧活动栏的调试图标，再点击顶部的“创建 launch.json 文件”链接。
3、在弹出的语言列表中选择当前项目使用的编程语言，例如 Python 或 JavaScript。
4、根据模板自动填充的配置，确保 program 字段指向正确的可执行文件路径，如 "program": "${file}" 表示调试当前打开的文件。
二、在代码行左侧灰色区域单击设置断点
断点是调试中最基础的触发机制，其本质是在指定代码行执行前强制暂停，使开发者能查看此时的调用栈、变量值与表达式求值结果。
1、在编辑器左侧的行号区域（即数字旁的空白灰条）找到目标代码行。
2、鼠标左键单击该行对应位置，出现一个实心红点即表示断点已成功添加。
3、再次单击同一位置可取消断点；按住 Ctrl 键（Windows/Linux）或 Cmd 键（macOS）并单击多个行号区域可批量添加断点。
4、将鼠标悬停在红点上，会显示断点类型提示，例如 普通断点 或 条件断点（需右键编辑）。
三、使用快捷键快速切换断点状态
当需要频繁启用或禁用某处断点而不删除时，快捷键操作可显著提升调试效率，避免误删关键断点。
1、将光标置于含断点的代码行任意位置。
2、按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板。
3、输入 Toggle Breakpoint 并回车，当前行断点即刻切换启用/禁用状态。
4、启用状态下断点为实心红点，禁用状态下为空心红点，界面右侧“断点”面板中也会同步更新状态标记。
四、右键设置条件断点与日志断点
条件断点仅在满足特定表达式时触发，适用于循环体内部或高频调用函数中定位异常场景；日志断点则替代 console.log，不中断执行但输出信息。
1、在已有断点位置右键，选择 编辑断点。
2、在弹出的输入框中填写 JavaScript 表达式，例如 i === 5 或 user.id > 100，回车确认。
3、若需添加日志断点，在同一右键菜单中选择 添加日志点，输入格式化字符串，如 "当前值: ${x}, 状态: ${valid}"。
4、保存后，该行左侧仍显示红点，但图标样式略有不同，悬停时会明确标注为 日志断点 或 条件断点。
五、通过调试控制台动态添加函数断点
函数断点不依赖源码行号，而是基于函数名注册，适用于第三方库未提供源码映射、或需在每次调用某函数时中断的场景。
1、启动调试会话后，确保调试控制台处于激活状态（可通过 Ctrl+Shift+Y 快速聚焦）。
2、在调试侧边栏中展开“断点”区域，点击底部的 + 函数断点 图标（或右键空白处选择“添加函数断点”）。
3、输入目标函数全名，例如 fetchData 或 Array.prototype.map，注意大小写与作用域匹配。
4、触发该函数调用时，无论其定义位置是否可见，调试器均会在进入函数第一行暂停执行。
