pytest-xdist需安装后显式加-n参数才启用并发：pip install pytest-xdist，本地双核用pytest -n 2，推荐自动适配用pytest -n auto；默认按test函数粒度分发，不加-n仍为单进程执行。

pytest-xdist 安装和基础并发启动方式

直接装完就能跑并发，但默认不生效——必须显式加 -n 参数。不加就还是单进程顺序执行。

• 安装：pip install pytest-xdist
• 本地双核跑 2 个进程：pytest -n 2
• 自动按 CPU 核数分配（推荐）：pytest -n auto
• 指定 worker 数量时，-n 0 是非法值，会报错 ValueError: n must be > 0

测试函数被拆分到不同进程的规则

pytest-xdist 默认按「test item」粒度分发，也就是每个 def test_* 函数单独调度，不是按文件、类或模块切分。

• 同一测试文件里的多个 test_* 函数，大概率被分到不同 worker，除非数量少于 worker 数
• 如果某个 test 函数里用了 time.sleep(5) 或 I/O 阻塞，它会独占一个 worker，拖慢整体进度
• 想强制让某组测试在同一个 worker 执行（比如共享 fixture 状态），得用 --dist=loadgroup + @pytest.mark.xdist_group(name="api")

共享资源冲突：临时目录、数据库、端口怎么破

并发下 tmpdir 或 tmp_path 虽然各自隔离，但像 SQLite 文件路径、HTTP 端口、Redis 连接这类全局资源极易撞车。

python-flask-vue-creator

创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。

下载

• 避免硬编码端口：用 socket.bind(("", 0)) 让系统分配空闲端口，再用 getsockname() 拿到实际值
• SQLite 不要复用同一文件路径；每个 worker 应生成唯一 DB 路径，例如基于 os.getpid() 或 worker_id（需通过 pytest_configure 注入）
• fixture 中初始化资源时，加锁或用 xdist_info 判断当前是否主进程（config.workerinput 不存在即为主）

调试失败测试时为什么看不到完整 traceback

默认情况下，worker 进程崩溃只在主进程输出简略错误，比如 Worker crashed while running ...，根本不知道哪行抛了异常。

• 加 --tb=short 或 --tb=long 可恢复完整 traceback，但注意 --tb=auto 在 xdist 下仍可能截断
• 更可靠的是加 --capture=no（或 -s），让 print/log 直接输出，便于定位卡点
• 如果测试依赖环境变量（如 ENV=staging），必须用 --tx "popen//env:ENV=staging" 显式透传，否则 worker 里读不到

并发本身不难，难的是状态隔离和错误可追溯——尤其是当某个 test 偶尔失败、换 worker 就消失时，大概率是没处理好资源竞争或随机种子。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！