Swoole不能通过phpEnv图形界面一键安装，必须手动编译并指定PHP实例路径；需先用phpenv versions和phpenv which php确认目标版本路径，再用对应/phpize和/php-config编译安装，最后在php.ini中添加extension=swoole.so并验证加载与协程功能。
Swoole 不能直接通过 phpEnv 图形界面一键安装，必须手动编译并指定 PHP 实例路径 —— 因为 phpEnv 默认不提供 swoole 扩展管理模块，且其内置的 PHP 是多版本共存结构，每个版本的 phpize 和 php-config 路径都不同。
确认 phpEnv 中目标 PHP 版本的实际路径
phpEnv 的 PHP 安装目录不是标准系统路径，而是类似 /phpenv/versions/8.1.22 这样的结构。若直接运行 phpize，大概率报错“command not found”或调用到系统全局 PHP 的工具链，导致扩展编译失败。
- 先查清你要装 Swoole 的 PHP 版本号：
phpenv versions - 再获取该版本完整路径：
phpenv which php（输出如/phpenv/versions/8.1.22/bin/php） - 据此推导出对应工具路径：
/phpenv/versions/8.1.22/bin/phpize和/phpenv/versions/8.1.22/bin/php-config - 验证是否可执行：
/phpenv/versions/8.1.22/bin/phpize -v，若提示缺失依赖（如autoconf），需单独安装
下载源码并用 phpEnv 对应工具编译安装
跳过 PECL（它默认调用系统 PHP 工具链，与 phpEnv 冲突），坚持源码编译是最稳妥的方式。关键在于所有 configure 步骤必须显式指向 phpEnv 管理的 PHP 实例。
- 下载 Swoole 源码（例如 v5.1.4）：
wget https://github.com/swoole/swoole-src/archive/refs/tags/v5.1.4.tar.gz - 解压并进入：
tar -xzf v5.1.4.tar.gz && cd swoole-src-5.1.4 - 用目标版本的
phpize初始化：/phpenv/versions/8.1.22/bin/phpize - 配置时必须指定
--with-php-config：./configure --with-php-config=/phpenv/versions/8.1.22/bin/php-config --enable-openssl --enable-http2 - 编译安装：
make && make install，成功后会输出类似Installing shared extensions: /phpenv/versions/8.1.22/lib/php/extensions/no-debug-non-zts-20210902/
启用扩展并验证协程功能
phpEnv 不会自动修改 php.ini，你得自己找到该 PHP 版本实际加载的配置文件 —— 它通常不在 etc/ 下，而是在 lib/ 或 etc/php.ini，具体路径可通过 /phpenv/versions/8.1.22/bin/php --ini 查看。
立即学习“PHP免费学习笔记（深入）”；
- 编辑输出中 “Loaded Configuration File” 对应的文件，末尾添加：
extension=swoole.so - 注意：不要加引号，也不要写成
extension="/full/path/swoole.so"（路径方式在 phpEnv 下易失效） - 验证是否加载：
/phpenv/versions/8.1.22/bin/php -m | grep swoole，有输出即成功 - 测试协程是否可用：
/phpenv/versions/8.1.22/bin/php -r "go(function(){co::sleep(0.1); echo 'ok';});"，无报错且输出ok才算真正就绪
最容易被忽略的是：phpEnv 切换版本后，php 命令指向的是新版本，但 CLI 下的 php -i 可能仍显示旧配置；务必每次用完整路径调用对应版本的二进制，尤其是验证阶段。编译参数里漏掉 --enable-coroutine（新版已默认开启，但低于 v4.8 的旧版需手动加）也会导致 go() 函数不存在 —— 这类细节在 phpEnv 环境下比普通服务器更难排查。
