Python异步协程库gevent，下载与安装全攻略

qbadmin 2026年09月14日 08:26 939 0

本攻略针对Python异步协程库gevent，详解其下载与安装全流程，gevent基于greenlet实现高效异步IO，是Python高并发开发常用工具，攻略覆盖多系统适配：Windows环境需先安装微软VC++ Build Tools解决编译依赖，Linux、macOS可通过pip常规安装，同时说明安装后验证方法，如导入gevent运行简单协程示例，助力开发者快速完成部署，为后续异步开发奠定基础。

Python异步开发神器：gevent的下载安装全指南

当你需要处理高并发的网络请求、批量爬取百万级数据，或是搭建轻量级异步Web服务时，Python的同步编程模型往往会遇到性能瓶颈——这时候，基于libevent的高性能协程库gevent就能帮你把阻塞式I/O转成异步执行，轻松把程序并发能力提升一个量级，本文将详细讲解不同场景下gevent的安装方法，以及踩坑指南,帮你快速开启高性能异步开发之旅。

最便捷的安装方式：pip一键部署

对于绝大多数普通用户，用Python包管理工具pip安装gevent是最简单高效的选择：pip会自动解析并安装所有依赖组件，无需手动处理任何冲突,是新手首选方案。

基础安装命令

打开终端（Windows用CMD/PowerShell，Mac/Linux用终端）,根据你的Python版本执行对应命令：

# Python2环境（已停止维护，不推荐使用）
pip install gevent

国内镜像加速（必看）

官方源下载速度慢是国内用户常遇到的问题，切换国内镜像源可大幅提升安装效率，常用源有清华、阿里、豆瓣：

# 清华源（推荐）
pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple gevent
# 阿里源
pip3 install -i https://mirrors.aliyun.com/pypi/simple/ gevent
# 豆瓣源
pip3 install -i https://pypi.douban.com/simple/ gevent

⚠️ 安装前建议先升级pip到最新版本,避免源解析或兼容问题：

pip3 install --upgrade pip

定制化需求：源码安装

如果你需要特定版本的gevent，或是要二次开发修改核心逻辑,源码安装是唯一选择。

源码下载渠道

GitHub官方仓库：访问https://github.com/gevent/gevent，进入Releases页面下载对应版本的源码压缩包；也可通过git克隆指定版本：
```
git clone https://github.com/gevent/gevent.git
cd gevent
git checkout 21.12.0  # 替换为你需要的版本号
```
PyPI官方源：在https://pypi.org/project/gevent/#files下载.tar.gz格式的源码包。

源码安装步骤

⚠️ 源码安装需要系统级C编译环境，Linux/Mac通常自带，Windows需提前安装Visual C++ Build Tools：

解压下载的源码包,进入解压后的目录；
执行安装命令：
```
python3 setup.py install
```

不同系统的避坑指南

不同操作系统对编译环境的要求差异较大,针对性处理才能避免安装失败。

Linux系统（Ubuntu/Debian/CentOS）

Linux下必须先安装系统级依赖,否则会出现编译错误：

Ubuntu/Debian系列：

sudo apt-get update
sudo apt-get install python3-dev libevent-dev

CentOS/RHEL系列：
```
sudo yum install python3-devel libevent-devel
```
⚠️ 如果提示找不到依赖，先更新源列表：sudo apt upgrade（Debian）或sudo dnf update（CentOS8+）。

Windows系统

Windows直接用pip安装通常会因缺少C编译环境报错,推荐用预编译的whl文件：

访问https://www.lfd.uci.edu/~gohlke/pythonlibs/#gevent，下载对应Python版本和系统架构的whl文件（如gevent-21.12.0-cp310-cp310-win_amd64.whl，cp310对应Python3.10，win_amd64是64位系统）；
用管理员身份打开CMD，执行安装：
```
pip install 你的whl文件完整路径
```
⚠️ 找不到对应版本whl时，建议升级/降级Python版本，或用conda安装：conda install gevent（自动处理依赖）。

Mac系统（含M1芯片）

英特尔芯片Mac：直接用pip安装即可；
M1芯片Mac：需指定编译架构，避免兼容性问题：
```
ARCHFLAGS="-arch arm64" pip3 install gevent
```
⚠️ 若仍报错，先安装Rosetta2：softwareupdate --install-rosetta。

验证安装是否成功

安装完成后，通过以下代码验证,同时体验gevent的并发效果：

import gevent
from gevent import monkey
# 核心：打补丁！必须放在导入其他标准库之前，才能将阻塞操作转为异步
monkey.patch_all()
# 定义两个协程任务
def task1():
    print("任务1开始")
    gevent.sleep(1)  # 模拟1秒阻塞（异步等待，不占用CPU）
    print("任务1结束")
def task2():
    print("任务2开始")
    gevent.sleep(1)
    print("任务2结束")
# 启动协程并等待所有任务完成
gevent.joinall([gevent.spawn(task1), gevent.spawn(task2)])

预期效果

运行代码后，任务1和任务2几乎同时开始，1秒后同时输出结束，这就是协程并发的优势——相比同步执行（需要2秒），gevent将耗时缩短到1秒,说明安装成功且生效。

常见安装问题排查

编译错误（如gcc failed）：缺少系统级依赖（libevent-dev等）,按上文对应系统的依赖安装命令执行；
Windows提示缺少VC编译工具：安装Microsoft Visual C++ Build Tools，或改用whl文件/conda安装；
协程不生效：monkey.patch_all()必须放在导入其他标准库（如requests、socket）之前,否则补丁不会生效；
版本不兼容：gevent 20.x+支持Python3.6+，若用旧Python版本，需指定旧版gevent：pip install gevent==1.5.0；
导入报错：提示ImportError: cannot import name 'gevent'，检查Python环境是否正确,或用管理员权限重新安装。