Python异步框架gevent的下载安装全指南

qbadmin 2026年09月07日 09:13 995 0

本指南针对Python异步框架gevent，提供完整的下载安装全流程方案，适配不同开发环境，核心覆盖三类主流安装方式：一是常规pip安装，通过PyPI源执行pip install gevent，适配多数Python版本；二是解决依赖问题的特殊安装，若遇libev相关报错，需提前安装系统级依赖（如Linux的libev-dev、Windows预编译包）；三是源码编译安装步骤，同时标注不同Python版本的适配注意事项，帮助开发者快速完成部署，为异步开发搭建基础。

Python高性能异步框架gevent：多场景安装指南与问题解决

gevent是Python生态中基于协程的高性能异步网络框架，依托轻量级协程库greenlet实现，相比传统线程/进程模型，协程切换无需内核态干预，成本极低，能在单线程内支撑数千甚至数万级并发，完美适配爬虫、微服务、高并发Web服务这类需要大量网络io等待的场景，是Python异步开发的核心工具之一，想要借助gevent开发高并发应用，第一步就是完成它的安装配置，本文将详细介绍gevent的多种安装方式、依赖准备及常见问题解决方案。

主流安装方式：pip快速安装

pip是Python最常用的包管理工具,也是安装gevent的首选方式，不过由于PyPI官方服务器位于海外，国内用户直接执行pip install gevent常出现下载超时、速度慢的问题，推荐使用国内镜像源加速（速度提升10倍以上）：

先升级pip（避免旧版本兼容问题）：
```
pip install --upgrade pip
```
使用国内源安装gevent（以清华源为例）：
```
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple gevent
```
若需要安装指定稳定版本,可在包名后加版本号（如安装适配旧项目的1.5.0版，注意：1.5.0是Python 2兼容的最后稳定版，当前推荐安装最新稳定版23.x系列）：
```
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple gevent==1.5.0
```

不同系统的依赖准备（解决编译错误）

gevent包含C扩展模块,部分场景下需要系统级依赖才能完成编译安装，不同系统的准备工作如下：

Linux（Ubuntu/Debian）：

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

Linux（CentOS/RHEL）： CentOS 8及以上版本可将yum替换为dnf：
```
sudo yum install libevent-devel python3-devel```
```
macOS：先安装Xcode命令行工具，再通过Homebrew安装libevent（若未装Homebrew，需先执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）：
```
xcode-select --install
brew install libevent
```
Windows： Windows下直接pip安装常因编译环境缺失失败，推荐使用conda包管理器安装（需先安装Anaconda/Miniconda）：
```
conda install -c conda-forge gevent
```

源码安装（获取最新/定制版本）

源码安装主要用于获取未正式发布的开发版特性,或需要自定义编译参数（如适配特定系统架构）的场景，普通用户推荐使用pip/conda安装稳定版：

克隆gevent仓库：若GitHub克隆速度慢，可使用国内镜像（如git clone https://hub.fastgit.org/gevent/gevent.git）：
```
git clone https://github.com/gevent/gevent.git
```
进入源码目录：
```
cd gevent
```

安装依赖并编译安装：

pip install -r requirements.txt
python setup.py install

也可直接通过pip安装GitHub上的开发版：

pip install git+https://github.com/gevent/gevent.git

安装成功验证

安装完成后,建议在虚拟环境中验证（避免影响系统全局Python依赖）：打开Python交互环境（输入python或python3），执行：

import gevent
print(gevent.__version__)

如果没有抛出ImportError或其他异常，且输出了版本号（当前最新稳定版为9.1左右，具体以实际安装为准），则说明gevent安装成功。

常见安装问题解决

下载速度慢/超时：更换国内镜像源（如阿里源https://mirrors.aliyun.com/pypi/simple/、豆瓣源https://pypi.douban.com/simple/），或临时使用VPN提升PyPI访问稳定性。
编译错误（如event2/event.h找不到）：该错误是因为缺少libevent开发头文件，需安装对应系统的libevent开发依赖（见第二部分），若源中无该包，可手动编译安装libevent。
版本不兼容：gevent 2.0+全面支持Python 3.6及以上，且对Python 3.10+支持更完善；若必须使用Python 2.7，建议安装最后兼容版本gevent==1.5.0。
Windows安装失败：优先使用conda安装，若仍失败，可前往Christoph Gohlke的Windows wheel包网站下载对应Python版本和系统架构的.whl文件，执行pip install 下载路径/gevent-xxx.whl手动安装。