什么是 Greenlet？
greenlet 是一个非常轻量级的 Python 协程库，它允许你在一个线程内自由地切换执行代码流，这种切换不是由操作系统或解释器自动完成的，而是由你显式地通过代码控制的。
你可以把它想象成一个“可以暂停和恢复的函数”，当一个 greenlet 暂停时，它会保存当前的执行状态（局部变量、指令指针等），当你恢复它时,它会从之前暂停的地方继续执行。
核心特点：
- 协作式多任务：与操作系统抢占式调度不同，
greenlet的切换是由程序主动交出控制权（greenlet.switch()）触发的，这意味着一个greenlet如果不主动切换，它会一直运行下去,可能会阻塞整个线程。 - 线程内切换：
greenlet的切换只能在同一个线程内进行。 - 底层基础：
greenlet是更高级别的并发库（如 gevent 和 eventlet）的基石，这些库使用greenlet来实现自动化的协程调度。
第一步：安装 Greenlet
greenlet 的安装非常简单，通常使用 pip 包管理器即可。
环境准备
确保你的系统已经安装了 Python（推荐 Python 3.6+）,你可以通过以下命令检查：
python --version # 或者 python3 --version
安装命令
打开你的终端（在 Windows 上是 CMD 或 PowerShell）,然后运行以下命令：
pip install greenlet
或者，为了更明确地使用 Python 3：
pip3 install greenlet
验证安装
安装完成后，你可以通过 Python 交互式环境来验证是否安装成功：
python >>> import greenlet >>> print(greenlet.__version__) # 或者直接检查是否导入成功，如果没有报错就说明安装成功了 >>> exit()
第二步：基本使用示例
下面是一个简单的例子，展示了如何创建和切换 greenlet。
from greenlet import greenlet
def test1():
print("T1: 1")
# 切换到 g2，并传递一个参数 "hello"
gr2.switch("hello")
print("T1: 3")
# 再次切换到 g2
gr2.switch()
def test2():
# 接收从 test1 传来的参数 "hello"
print(f"T2: Received from T1: {msg}")
msg = gr1.switch() # 切换回 g1
print(f"T2: Received from T1 again: {msg}")
# 创建两个 greenlet 实例
# 它们初始时都处于 "started" 状态，但尚未运行
gr1 = greenlet(test1)
gr2 = greenlet(test2)
# 启动 gr1，它会开始执行 test1 函数
# gr1 是 "running" 状态，gr2 是 "dead" 状态
print("Starting gr1...")
msg = gr1.switch() # 启动 gr1，它会执行到 test1 内的 gr2.switch() 处
# 当 gr1 切换到 gr2 后，gr1 变为 "switched" 状态，gr2 变为 "running" 状态
# gr2 执行完毕后，会切换回 gr1
# gr1 再次运行，直到结束，变为 "dead" 状态
print(f"Back in main, final message from T1: {msg}")
输出结果：
Starting gr1...
T1: 1
T2: Received from T1: hello
T1: 3
Back in main, final message from T1: None代码解析：
- 我们定义了两个函数
test1和test2，它们内部都调用了greenlet.switch()。 greenlet(test)创建了一个新的协程对象gr，它将执行test函数。gr1.switch()是启动gr1的方式，一旦调用，程序的控制权就从主线程转移到了test1函数。- 在
test1中，gr2.switch("hello")将控制权转移给test2，并将字符串"hello"作为参数传递过去。 test2执行完毕后，gr2.switch()再次将控制权交还给test1的gr2.switch()语句的下一行。test1执行完毕，gr1.switch()返回None（因为test1没有显式返回值）,控制权回到主线程。
第三步：Greenlet 的实际应用场景
直接使用 greenlet 进行手动切换比较繁琐，它更多的是作为其他库的底层组件，在实际开发中，你更可能使用基于 greenlet 的高级库。
Gevent (最常用)
gevent 是一个基于 greenlet 的网络库，它通过 monkey-patching（猴子补丁）技术，将 Python 的标准库（如 socket, threading 等）变成非阻塞的，这使得你可以用同步的代码风格编写异步的 I/O 操作。
安装 Gevent:
pip install gevent
Gevent 示例 (模拟并发下载):
import gevent
from gevent import monkey
# 打猴子补丁，必须在导入任何标准库网络模块之前执行
monkey.patch_all()
import urllib.request
def fetch(url):
print(f"Fetching {url}...")
try:
# urllib.request.urlopen 在打完猴子补丁后是“异步”的
# 它在等待网络响应时会自动切换到其他 greenlet 执行
response = urllib.request.urlopen(url)
data = response.read()
print(f"Fetched {url} successfully, length: {len(data)} bytes")
except Exception as e:
print(f"Error fetching {url}: {e}")
# 创建多个 greenlet
urls = [
'http://www.python.org',
'https://github.com',
'http://www.example.com'
]
gevents = [gevent.spawn(fetch, url) for url in urls]
# 等待所有 greenlet 执行完毕
gevent.joinall(gevents)
print("All downloads complete.")
在这个例子中，gevent.spawn 创建了多个协程，当一个协程在等待网络 I/O 时，gevent 会自动将其暂停，并运行另一个已经准备好的协程,从而实现高效的并发。
Eventlet
eventlet 是另一个与 gevent 类似的库，也基于 greenlet，提供了自己的 WSGI 服务器（如 eventlet.wsgi）。
常见问题与注意事项 (FAQ)
Q1: greenlet 和 Python 的 asyncio 有什么区别？
| 特性 | greenlet / gevent |
asyncio |
|---|---|---|
| 模型 | 协作式多任务，基于显式/隐式切换 | 协作式多任务，基于 await/yield 关键字 |
| 调度器 | gevent 使用事件循环；greenlet 无调度器 |
核心自带事件循环 |
| 代码风格 | 同步风格，代码直观 | 异步风格，需要 async def 和 await |
| 依赖 | gevent 依赖 C 扩展 (greenlet) |
纯 Python，标准库自带 (Python 3.4+) |
| 适用场景 | 网络密集型 I/O，特别是需要快速改造现有同步代码时 | 网络和磁盘 I/O，以及复杂的并发控制逻辑 |
| 生态系统 | 生态较小，但 gevent 在特定领域（如 Web 框架集成）很成熟 |
生态非常庞大，是 Python 官方推荐的异步方案 |
asyncio 是 Python 内置的现代异步解决方案，而 gevent 是一个成熟的第三方库，两者都能高效处理 I/O 密集型任务,但实现方式和编程范式不同。
Q2: 安装时遇到 error: Microsoft Visual C++ 14.0 or greater is required 怎么办？
这是在 Windows 上从源码编译 greenlet 时遇到的常见错误，因为 greenlet 包含 C 扩展。
解决方案：
- 安装 Microsoft C++ Build Tools：这是最根本的解决方法，访问 Visual Studio 下载页面，下载 "Build Tools for Visual Studio"，在安装时选择 "使用 C++ 的桌面开发" 工作负载。
- 使用预编译的 Wheel 文件：
pip通常会自动为你选择合适的预编译版本，如果不行，你可以尝试指定--only-binary参数来强制使用二进制包：pip install --only-binary=:all: greenlet
Q3: 什么时候应该使用 greenlet/gevent？
- 当你需要将现有的同步代码快速改造为高并发代码时：
gevent的猴子补丁机制非常方便,你几乎不需要改动业务逻辑代码。 - 当你使用的框架（如 Pyramid、Flask + Gunicorn）与
gevent结合得很好时：许多 Web 服务器和框架都原生支持gevent。 - 对于简单的网络爬虫或 API 调用任务：
gevent可以让你轻松实现并发请求,提高效率。
- 安装：
pip install greenlet，如果遇到编译问题，请安装 C++ Build Tools。 - 理解：
greenlet是一个手动切换的协程库，是gevent的基础。 - 使用：在大多数情况下，你会直接使用
gevent，它提供了自动化的协程调度，让你用同步的写法处理异步的 I/O。 - 选择：
greenlet/gevent和asyncio都是强大的工具，根据项目需求、团队熟悉度和现有生态来选择合适的方案，对于新项目，asyncio通常是更现代和推荐的选择。
