phpize 命令未找到是因未安装 php-dev（Ubuntu/Debian）或 php-devel（RHEL/CentOS/Fedora）包；configure 报错如 missing pcre.h 需装 libpcre3-dev 或 pcre-devel；swoole 不显示需确认 php.ini 路径、extension_dir 及 extension=swoole.so 配置，并重启对应服务；API mismatch 警告源于编译与运行 PHP 版本不一致，须统一使用匹配的 phpize 和 php-config 绝对路径。
phpize 找不到或报 command not found
这是最常见卡点，本质是 PHP 开发头文件和构建工具没装全。phpize 不是独立程序，而是 php-dev（Debian/Ubuntu）或 php-devel（RHEL/CentOS/Fedora）包提供的脚本。不装它，连编译起点都没有。
- Ubuntu/Debian：运行
sudo apt install php-dev（注意：若装了多个 PHP 版本，比如php7.4-dev或php8.1-dev，得装对应版本的 dev 包） - CentOS/RHEL 8+：用
sudo dnf install php-devel；7 及以前用sudo yum install php-devel - 装完验证：
which phpize应输出路径，如/usr/bin/phpize或/usr/local/bin/phpize
configure 报错 missing pcre.h 或 zend_log.h
这类错误都指向「头文件缺失」——不是代码写错了，是系统缺编译依赖。尤其 pcre.h 缺失，会导致整个 configure 中断；而 zend_log.h 类错误，往往说明你用了高版本 Swoole 源码去编译低版本 PHP（比如用 Swoole 5.x 编译 PHP 7.2），或 php-config 路径指错了。
-
pcre.h缺失：Ubuntu/Debian 装libpcre3-dev；CentOS/RHEL 装pcre-devel -
zend_log.h或类似 Zend API 相关报错：先确认 PHP 版本是否 ≥ 7.3（Swoole 4.8+ 要求），再检查php-config路径是否准确——用find / -name php-config 2>/dev/null找真实路径，然后./configure --with-php-config=/your/path/to/php-config - 别直接 git clone 主干代码：GitHub
main分支常含未稳定 API，优先下载 releases 页面 的稳定 tar.gz 包（如swoole-5.1.3.tgz）
make install 后 php -m 看不到 swoole
安装成功 ≠ 扩展被加载。90% 这类问题出在三处：路径错、配置漏、服务没重启。
- 查真实
php.ini路径：php --ini输出 “Loaded Configuration File”，别凭经验改错文件（比如 CLI 和 FPM 用不同 ini） - 确认
swoole.so文件真在extension_dir指向的目录里：php -i | grep extension_dir，然后ls -l $(php -r "echo extension_dir;")/swoole.so - 在正确
php.ini里加一行：extension=swoole.so（不要写绝对路径，除非你明确需要；也不要加引号） - CLI 测试用
php -m | grep swoole；Web 环境必须重启对应服务：sudo systemctl restart php-fpm或sudo systemctl restart apache2
PHP Warning: Unable to initialize module（API mismatch）
这个警告意味着 Swoole 扩展和当前 PHP 运行时的 ABI 不兼容。根本原因是：编译时用的 phpize 和 php-config 来自 A 版本 PHP，但运行时调用的是 B 版本 PHP（比如编译用 PHP 8.0，运行用 PHP 8.2）。
- 最稳做法：所有命令都用绝对路径，例如：
/usr/local/php82/bin/phpize→./configure --with-php-config=/usr/local/php82/bin/php-config→/usr/local/php82/bin/php -m - 别混用包管理器装的 PHP 和源码编译的 PHP：比如 Ubuntu
apt install php8.2和你自己./configure && make install的 PHP 共存时，务必分清 bin 路径和 ini 路径 - 如果已装错，删掉错误的
swoole.so，清空编译目录（make clean），再用匹配的工具链重来
/etc/php/8.2/cli/php.ini，FPM 仍可能读着 /etc/php/8.2/fpm/php.ini，而 Apache 又另有一套。不逐个确认，就永远卡在“明明装了却看不到”。 
