vscode 中 pytest-xdist 多核并行必须手动隔离资源，否则会随机失败；断点不触发因调试器未注入子进程，需满足 python 扩展 ≥2023.10.0、debugpy ≥1.6.0、launch.json 同时配置 "subprocess": true 和 "console": "integratedterminal" 三条件。
VSCode 里跑 pytest-xdist 多核并行，不隔离资源就必然出错——不是报错，而是随机失败、数据库 locked、文件被删、断点不触发。
为什么 VSCode + pytest-xdist 容易“看似跑通实则崩坏”
VSCode 默认调试器只 attach 主进程，pytest-xdist 启的每个 worker 都是独立 Python 进程，它们不共享内存、不继承主进程的调试上下文，也不自动加载你本地写的 conftest.py 中的 session 级 fixture（除非显式声明 autouse=True）。更关键的是：VSCode 的 subProcess: true 不是开关一开就生效，它依赖底层 debugpy 版本和启动方式。
- 常见现象：断点打在
test_xxx()函数第一行，F5 启动后直接跳过，控制台输出一堆测试名但没停住 - 根本原因：worker 进程没被注入调试器，或者用了
fork方式启动（Windows/macOS 不支持 fork 调试） - 另一个隐形坑：VSCode 的集成终端默认用
bash或zsh，但pytest -n auto在 Docker CI 中会误读为 1 核，导致本地能跑、CI 里变单核
VSCode launch.json 必须满足的三个硬条件
缺一不可，否则子进程永远进不了调试器：
-
Python 扩展版本 ≥ 2023.10.0（检查 Settings → Extensions → Python → Version） -
debugpy ≥ 1.6.0（运行pip show debugpy确认，旧版不支持 spawn 模式下的子进程注入） -
launch.json中同时含"subProcess": true和"console": "integratedTerminal"；"justMyCode": true可选但推荐
示例配置片段（加到 .vscode/launch.json 的 configurations 数组里）：
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
{
"name": "pytest-xdist debug",
"type": "python",
"request": "launch",
"module": "pytest",
"args": ["-n", "2", "-s", "-v", "tests/"],
"console": "integratedTerminal",
"subProcess": true,
"justMyCode": true
}
资源隔离必须手动做，不能靠“感觉”
pytest-xdist 不会帮你隔离 DB、临时文件、全局变量。它只管分发 test function，不管你怎么初始化环境。比如 SQLite 文件锁、tempfile.mkdtemp() 返回相同路径、os.chdir() 切错目录，都会在多进程下爆炸。
- DB 隔离：别用
:memory:（它不跨进程），改用带 worker ID 的文件路径：sqlite3.connect(f"test_{workerinput['workerid']}.db")，其中workerinput来自pytest_configure或 fixture 参数 - 临时目录：用
@pytest.fixture(scope="session")创建根临时目录，再让每个 worker 在其下建子目录，路径传入workerinput - 避免
scope="session"返回可变对象（如 dict/list），否则多个 worker 修改同一引用，结果互相覆盖 - 禁用共享状态的测试：在文件顶部加
# pytest: noxdist注释，它比@pytest.mark.xfail管用
进程数和 --dist 模式怎么选才不翻车
盲目 -n auto 或 -n 8 是最常见错误。真实瓶颈往往不在 CPU，而在 I/O 或资源争抢。
- CPU 密集型（数值计算、加密）：
-n不超过物理核心数，超线程核心不算；Linux 下可配mp.set_start_method("spawn") - I/O 密集型（HTTP 请求、DB 查询）：
-n可设为core_count × 2，但要观察htop或docker stats，CPU 持续低于 30% 就说明不是 CPU 瓶颈 - --dist 模式选错 = 白配：跨文件共享 DB？用
--dist=loadfile；类内 fixture 共享状态？用--dist=loadscope；有明确执行顺序依赖？别并行，或用--dist=loadgroup+@pytest.mark.group1
最容易被忽略的点：VSCode 终端里跑 pytest -n 4 时，stdout/stderr 会乱序混杂，看不出哪条 log 属于哪个 worker —— 要加 --log-file 或用 pytest-asyncio 配合 logging 的 extra 字段打 worker ID。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
