2. 环境基础：操作系统要求、Python版本选择、虚拟环境搭建与依赖管理

多批次并行召回通知链路涉及异步I/O、多进程调度、协议栈绑定与系统级信号处理，因此开发与调试环境必须严格对齐生产级稳定性。本节从操作系统、Python 版本、虚拟环境与依赖管理四个维度给出可复现的配置方案。

2.1 操作系统要求

推荐使用 Linux 内核 5.10+ 发行版（Ubuntu 22.04 LTS / CentOS Stream 9 / Debian 12），原因如下：

• epoll / io_uring 支持：高并发通知链路依赖事件驱动模型，Linux 5.10+ 原生提供 io_uring 接口，可显著降低系统调用开销。
• cgroup v2 与 CPU 亲和性：多批次并行场景需隔离资源，cgroup v2 在 5.10+ 内核中为默认且稳定。
• 网络协议栈调优：通过 sysctl 可调整 net.core.somaxconn、net.ipv4.tcp_tw_reuse 等参数，适配高吞吐通知链路。

2.2 Python 版本选择

本课程所有协议调试代码基于 Python 3.11+，具体版本锁定为 3.11.9。选择依据如下：

• asyncio 稳定性：3.11 引入 TaskGroup 与 ExceptionGroup，原生支持结构化并发，适合多批次并行召回任务编排。
• 性能提升：3.11 比 3.10 平均快 10–60%，在协议解析与序列化环节收益明显。
• 类型注解增强：Self 类型与 Variadic Generics 使协议栈接口定义更严谨。

2.3 虚拟环境搭建

使用 venv 创建隔离环境，避免系统级 Python 包污染。以下为标准化搭建流程：

1. 确认 Python 版本：python3.11 --version 应输出 Python 3.11.9。
2. 创建虚拟环境：python3.11 -m venv .venv。
3. 激活环境：
   • Linux/macOS：source .venv/bin/activate
   • Windows (PowerShell)：.venv\Scripts\Activate.ps1
4. 验证隔离性：which python 应指向 .venv/bin/python。

# 完整创建与激活示例（Linux）
python3.11 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip setuptools wheel

2.4 依赖管理

多批次并行召回通知链路的核心依赖分为三类：协议层、异步调度层与调试工具层。以下为锁定版本后的依赖清单：

使用 pip freeze > requirements.txt 锁定全量依赖，确保团队成员与 CI/CD 环境一致。

# requirements.txt 示例（仅核心依赖）
protobuf==4.25.3
grpcio==1.62.1
anyio==4.3.0
httpx==0.27.0
pytest-asyncio==0.23.6
structlog==24.1.0

2.5 环境配置总览

下图展示了从操作系统到 Python 虚拟环境、再到依赖管理的完整配置层级关系：