最基础安装方式是直接运行pip install aiohttp；遇网络慢可加清华或腾讯镜像源；需高性能时可选装aiodns、cchardet和aiohttp[speedups]；验证需在对应python环境中执行import aiohttp。
直接运行 pip install aiohttp 就行
这是最基础、最通用的安装方式，适用于绝大多数场景。只要你的 Python 版本 ≥ 3.5（2026 年基本都满足），且 pip 是最新版，执行这行命令就能装好核心功能。
遇到慢或超时？换国内镜像源
国内直连 PyPI 经常卡在下载阶段，错误信息通常是 ReadTimeoutError 或 ConnectionError。别反复重试，直接加镜像参数：
pip install aiohttp -i https://pypi.tuna.tsinghua.edu.cn/simple/- 或者用更稳定的腾讯源：
pip install aiohttp -i https://mirrors.cloud.tencent.com/pypi/simple/
注意：-i 参数必须写在包名之后、其他参数之前；路径末尾的 /simple/ 不能漏，否则会报 404。
想提升性能？按需加可选依赖
默认安装只含基础功能。如果你实际要跑高并发客户端或服务器，建议额外装几个加速组件：
- DNS 解析加速：
pip install aiodns（尤其对大量域名请求有效） - 字符编码检测加速：
pip install cchardet（处理非 UTF-8 响应更快） - 底层解析优化（C 扩展）：
pip install aiohttp[speedups]（需编译环境，Windows 用户可能报错）
这些不是必须的，但不装的话，aiohttp 在解析响应体或查 DNS 时会退回到纯 Python 实现，吞吐量可能下降 20%–40%。
验证是否真装好了
别只看终端输出 “Successfully installed”，得进 Python 环境里 import 一下：
python -c "import aiohttp; print(aiohttp.__version__)"
如果报 ModuleNotFoundError，常见原因有三个：
- 你在虚拟环境中装了，却在系统 Python 里测试（或反过来）
- 用了
pip3安装，但执行的是python（Python 2）命令 - IDE（如 VS Code、PyCharm）没刷新解释器路径，仍指向旧环境
最稳的验证方式：先确认当前 shell 的 python 和 pip 是同一套，再 import。
