VSCode调试Python多线程必须启用"subProcess": true，否则子线程断点不触发；多进程还需spawn启动方式、顶层可导入函数及"console": "integratedTerminal"等条件。
VSCode 调试 Python 多线程必须启用 subProcess，否则子线程断点永远不会命中；多进程调试依赖同一机制但需额外满足函数可导入、启动方式为 spawn 等条件——不配就只能看到主线程/主进程，其他线程卡在 threading.Thread.start() 之后、join() 之前，却毫无提示。
多线程断点不触发？检查 debugpy 和 launch.json 两个硬性条件
VSCode 默认用 debugpy（不是已弃用的 ptvsd）做后端，但即使版本正确，subProcess 不开，子线程就完全“隐身”。你看到的只是主线程单步执行，而 threading.Thread(target=lambda: print("here")).start() 后的 lambda 内容根本不会被调试器扫描。
- 确认调试控制台顶部日志含
debugpy version 1.6.0+，若出现ptvsd或初始化失败报错，先运行pip uninstall ptvsd和pip install --upgrade debugpy - 在
.vscode/launch.json的 Python 配置中，必须包含这两项："subProcess": true和"justMyCode": false（后者非绝对必需，但能避免因标准库线程启动逻辑跳过断点） -
"console": "integratedTerminal"推荐加上，防止internalConsole在多线程输出时丢日志或卡死 - 断点必须打在子线程函数体第一行可执行语句上，比如
print("in thread")，而不是threading.Thread(...).start()那一行
为什么变量窗口看不到子线程局部变量？
VSCode 调试界面默认只显示当前选中的调用栈帧对应的变量，不是所有线程变量的合并视图。当你在多个线程都停住时，左侧 CALL STACK 面板会列出 MainThread、Thread-1、Thread-2 等，但 Variables 面板内容取决于你点击了哪一项。
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
- 手动点击
CALL STACK中某一线程名（如Thread-1），Variables 面板立即刷新为该线程的局部作用域 - 全局变量（模块级或
global声明的）在任意线程上下文中都可见，但值反映的是最新写入状态——注意竞态，它不是快照 - 如果某线程没暂停（比如还在
time.sleep(5)中），它的局部变量不可见，这是正常行为，不是调试器缺陷
多进程调试：subProcess 开了还不够，得看启动方式和函数位置
"subProcess": true 对 multiprocessing 生效的前提是：子进程能被 debugpy 自动注入调试逻辑。这要求它由标准启动方法创建，且入口函数必须可被模块直接导入——否则 debugpy 找不到代码上下文，断点变空心圆。
立即学习“Python免费学习笔记（深入）”；
- 显式设置启动方法：
import multiprocessing as mp; mp.set_start_method('spawn')（Windows/macOS 必须，Linux 可选但推荐） - 子进程目标函数不能定义在
if __name__ == '__main__':块内，也不能嵌套在其他函数里；必须放在模块顶层，例如：def worker(): ...直接写在.py文件开头附近 - 确保
launch.json中配置了"console": "integratedTerminal"，否则 spawn 模式下子进程可能因缺少终端环境静默退出 - 如果仍无法捕获，可在子进程函数开头加
import debugpy; debugpy.listen(5678 + os.getpid() % 100); debugpy.wait_for_client()，再手动用Python: Attach配置连过去（端口要匹配）
容易被忽略的细节：线程生命周期太短、优化干扰、路径不一致
最常被漏掉的不是配置，而是运行时行为本身——比如 t = threading.Thread(...); t.start(); t.join() 这种写法，线程刚启就等结束，VSCode 根本来不及附加；又或者你在 PYTHONOPTIMIZE=1 下运行，lambda 和闭包被优化掉，断点绑定失败。
- 调试期间禁用 Python 优化：
"env": {"PYTHONOPTIMIZE": "0"}加进 launch.json - 统一 Python 解释器路径：按
Ctrl+Shift+P→Python: Select Interpreter，确保主进程和子进程用同一个解释器（尤其虚拟环境路径要一致） - 不要依赖
threading.current_thread().name判断线程身份——它可能被重命名；优先用threading.get_ident()或打印os.getpid()+threading.get_native_id()辅助定位 - 每次修改
launch.json后必须全量重启调试会话，热重载不生效
