如果 Mac 上的 VS Code 断点变成了空心灰色圆圈，说明调试器未能注册该断点。首先检查该行是否可以执行，以及当前活动的调试器是否支持该文件。然后确认调试会话运行的代码与您正在编辑的代码一致。仅凭指示图标本身无法确定具体原因；本排查步骤有助于逐步缩小范围，无需盲目尝试通用修复方法。VS Code 调试指南详细介绍了空心圆圈及其常见原因。

确认您看到的断点状态

实心红圈表示已启用的断点；实心灰圈表示已禁用的断点。空心灰圈表示调试器无法注册该断点。VS Code 文档指出了两个常见原因：该行没有可执行代码，或者调试器不支持该源文件。会话启动时，无法注册的断点也可能显示为空心；在不支持实时编辑的会话期间修改源代码也会导致出现相同的指示图标。具体表现可能因语言和调试器扩展而异。

在 macOS 上，按 Shift–Command–D 打开运行和调试。在其断点（BREAKPOINTS）区域中，找到相关条目并确认其已启用。此视图可让您管理断点，但它本身无法说明调试器为何拒绝某个断点。请保持编辑器打开在标记行处，以便将源位置与会话正在使用的文件进行对比。VS Code：调试代码

检查该行是否可以执行

将断点移至执行操作的代码行（例如函数内部的语句），而不是空白行、注释或括号。断点仅在调试器能够暂停执行的位置有效。如果在启动会话后，替换的标记变成了实心红圈，则说明原代码行可能没有可执行代码。这是根据文档所述行为做出的诊断推断，并非绝对保证：具体支持情况和断点绑定取决于调试器和语言。

如果代码是生成的、转译的、打包的，或者以其他方式与正在运行的程序所执行的文件不同，调试器可能需要 Source Map 或其他特定于语言的配置来将编辑器位置与运行时代码关联起来。VS Code 通用指南并未针对这种情况提供单一的通用配置。在更改映射设置之前，请先查阅您使用的调试器扩展和构建配置的文档。

检查活动的调试器和会话

VS Code 内置了对 JavaScript、TypeScript 和 Node.js 的调试支持。其他语言和运行时通常需要相应的调试器扩展。确认已安装并启用了相关扩展，然后为匹配的语言或运行时启动会话。如果 VS Code 提示您选择调试器，请选择与您打算运行的程序相匹配的调试器。扩展的文档中定义了其支持的源文件、断点行为以及启动选项。VS Code：调试代码

按 F5 开始调试，或使用运行和调试选择配置。简单的程序可以直接从活动文件运行，但具有特定入口点、参数、环境变量或挂载（attach）目标的应用程序可能需要 launch.json 配置。对于挂载配置，请确保目标进程已在调试模式下运行，并且连接详细信息匹配。如果断点放置正确，但文件与程序加载的源码不一致，该断点仍可能保持未验证状态。VS Code：配置调试

通过简短的步骤缩小原因范围

请按以下顺序排查，每次只更改一项，以确保结果具有参考价值：

  1. 在断点中，验证断点是否已启用，并记下其文件和行号。
  2. 将其移动到该文件中的可执行语句上。
  3. 按 F5 启动所需的调试配置，查看标记是否成功注册。
  4. 如果仍为空心，请验证所选调试器是否支持该文件，以及其扩展是否已安装并启用。
  5. 检查配置是否启动或挂载到了从您正在查看的源代码构建的程序。检查其入口点、工作目录以及与项目相关的任何构建或预启动（pre-launch）任务。
  6. 如果应用程序对源码进行了转换，请参阅语言调试器的说明，了解如何将编辑器文件映射到运行时代码。

某一次检查成功并不代表项目中的每个断点都有效；请在具体的源代码位置重复检查。如果调试器报告了配置或注册错误，请使用该提示信息并参考扩展文档来进行下一步调整。避免复制其他调试器的设置：VS Code 指出，配置属性和功能取决于所选的调试器和请求类型。VS Code：配置调试

指示图标能告诉您什么，不能告诉您什么

空心圆圈表示调试器尚未注册该断点。它本身无法区分是不可执行行、不支持的源文件、编辑器与运行时代码之间的不匹配，还是其他特定于调试器的限制。最有用的下一步是在目标会话中测试一行明确可执行的代码；如果注册仍然失败，再验证调试器和源映射（source mapping）。在 Mac 上，核心操作控件是相同的 VS Code 编辑器边槽、运行和调试视图、F5 以及 Shift–Command–D；特定于调试器的修复方法必须参考扩展或运行时文档。

来源