pymongo 在 python 3.11 上安装失败主因是 pip 版本过低（
PyMongo 在 Python 3.11 上安装失败，大概率不是代码兼容问题（PyMongo 4.0+ 已原生支持 3.11），而是 pip 版本太旧、没拉到适配的二进制轮子（manylinux 或 win_amd64），或被源阻塞导致降级到源码编译失败。
pip 版本低于 22.3 会跳过 PyMongo 的二进制轮子
Python 3.11 发布后，PyPI 对 wheel 标签做了调整：cp311 标签从 2022 年底起才被广泛支持。旧版 pip（如 21.x）无法识别 py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64 这类新标签，于是自动 fallback 到源码包（.tar.gz），而 PyMongo 源码编译依赖 libbson 和 C 构建工具链，在 Windows/macOS 上极易失败。
- 运行
pip --version，若输出pip 21.3.1或更低，必须升级 - 执行
python -m pip install --upgrade pip（不要用pip install --upgrade pip，避免 pip 自锁） - 升级后验证：
pip debug --verbose中应看到cp311出现在supported_tags列表里
安装时强制指定平台轮子（绕过 pip 自动匹配缺陷）
即使 pip 较新，某些网络环境或镜像站仍可能返回不带 cp311 标签的旧轮子。可手动下载并安装官方预编译 wheel：
构建并发布在 Quartz 平台上的韩语网络小说连载（草稿→封面→webp→章节 md→lint→发布），使用 Nano Banana Pro + ffmpeg。
- 访问 PyMongo PyPI 页面，找带
cp311的.whl文件（例如pymongo-4.8.1-cp311-cp311-win_amd64.whl） - 用
pip install /path/to/downloaded/pymongo-4.8.1-cp311-cp311-win_amd64.whl直接安装 - Linux/macOS 用户注意：别下错
manylinux变体，manylinux_2_17兼容 CentOS 7+，manylinux_2_28需 glibc 2.28+（较新发行版）
国内网络下 pip install pymongo 卡住或报 404
不是包不存在，是默认源（pypi.org）响应慢或被限流，pip 尝试多次失败后误判为“no version satisfies”，尤其在解析 JSON API 时超时会导致整个安装流程中断。
- 临时换源安装：
pip install pymongo -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn - 永久配置（避免每次敲）：编辑
pip.conf（Linux/macOS）或pip.ini（Windows，路径通常是%APPDATA%\pip\pip.ini），加入：
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple/ trusted-host = pypi.tuna.tsinghua.edu.cn
注意：如果已配置过其他镜像（如豆瓣、阿里云），请确认其是否已同步 PyMongo 4.6+ 的 cp311 轮子——部分老镜像会缓存旧版本索引，造成“找不到匹配版本”假象。
真正卡点往往不在 PyMongo 本身，而在 pip 是否能准确拿到 cp311 标签的 wheel；一旦走源码编译路径，Windows 缺 C++ Build Tools、macOS 缺 Xcode command line tools、Linux 缺 build-essential 都会立刻报错，且错误信息分散（error: Microsoft Visual Studio not found、clang: error: no such file or directory: 'src/bson/bson.c' 等）。先盯住 pip debug --verbose 输出里的 supported_tags，比盲目重装 Python 或降级 PyMongo 更省时间。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
