vscode调试python多线程必须启用"subprocess": true并使用debugpy≥1.6.0，否则子线程断点不触发、变量不可见；需手动点击call stack中对应线程切换上下文才能查看其局部变量。
VSCode 默认不自动捕获子线程或子进程的断点，必须显式启用对应调试支持，否则断点静默失效、变量不可见、调用栈缺失。
Python 多线程断点不触发？检查 debugpy 和 subProcess 配置
debugpy 是当前唯一受官方支持的 Python 调试器；ptvsd 已弃用且不兼容多线程断点。若看到调试控制台出现 Failed to initialize debugger 或含 ptvsd 字样，说明环境异常。
- 运行
pip uninstall ptvsd彻底移除旧调试器 - 执行
pip install --upgrade debugpy确保版本 ≥ 1.6.0 - 在
.vscode/launch.json的配置中必须包含"subProcess": true -
"justMyCode": false建议开启，避免跳过第三方库内关键逻辑
注意：subProcess: true 会让 debugpy 动态注入线程钩子，首次命中子线程断点可能有轻微延迟，属正常现象。
Node.js Web Worker 断点无效？必须走 Chrome Workers 面板 + 正确 source map 映射
VSCode 本身无法直接调试 Web Worker；所有断点、console.log、debugger 都只在 Chrome DevTools 的 Workers 独立窗口中生效。主线程 DevTools 完全看不到 Worker 输出。
- Worker 必须用
new Worker()实例化，不能import模块——后者只是静态解析，未创建线程 - Vite 项目推荐写法：
const worker = new Worker(new URL('./counter.worker.ts', import.meta.url), { type: 'module' }) -
launch.json中需配齐四项："type": "chrome"、"url": "http://localhost:5173"、"webRoot"（指向项目根目录，非src）、"sourceMapPathOverrides" - 映射规则示例（Vite）：
"http://localhost:5173/src/workers/*": "${webRoot}/src/workers/*"
验证方式：打开 Chrome DevTools → More tools → Workers → 找到对应 Worker 并点击 inspect；若 Sources 面板中 Worker 文件显示为灰色或空内容，说明 source map 路径映射失败。
Java 虚拟线程断点混乱？优先设 Suspend Policy 为 Thread
Java 21+ 虚拟线程数量可达百万级，若调试器默认采用 All 挂起策略，会导致 UI 卡死、响应迟滞甚至崩溃。
- 在 VSCode 的 Java 调试配置中，显式设置
"suspendPolicy": "Thread"（非默认值） - 配合条件断点过滤目标线程，例如：
thread.getName().contains("request-") && requestId == 1001 - 避免使用无条件断点，尤其在
ForkJoinPool或VirtualThread启动密集处 - 如需观察线程状态变化，用
Logpoint替代断点，格式如：log: "vthread ${thread.name} processing ${item.id}"
注意：VSCode 的线程列表默认只显示活跃且已暂停的虚拟线程；未暂停的线程不会出现在 CALL STACK 面板中——这不是丢失，是设计使然。
通用技巧：切换线程上下文才能看对变量
VSCode 的 Variables 面板永远只显示「当前选中的调用栈帧」对应的局部变量，而非所有线程变量的合并视图。这是最常被忽略的操作盲区。
- 调试时左侧 CALL STACK 面板会列出所有已暂停线程（如
Thread-1、Worker Thread #3、MainThread） - 必须手动点击某一线程名，才能将 Variables、Watch、Debug Console 切换到该线程上下文
- 全局变量（模块级或
static）在任意线程上下文中都可见，但值反映的是最新写入结果，注意竞态 - 若某线程未暂停，其局部变量天然不可见——不是调试器缺陷，是线程生命周期决定的
真正复杂的点不在配置，而在你是否记得每次暂停后主动点击 CALL STACK 里的线程名；没这一步，你看到的永远只是主线程的快照。
