pspell扩展必须在编译php时通过--with-pspell参数启用，无法用pecl动态安装；需先安装aspell及开发包，再用configure_opts指定参数重新编译phpenv版本，编译后直接可用，无需php.ini配置extension。
phpenv 本身不提供扩展管理能力，pspell 扩展必须在编译 PHP 时显式启用，不能像 redis 那样用 pecl install 动态加装。你用 phpenv 安装的每个 PHP 版本，都得单独重新编译并带上 --with-pspell 参数，否则 extension=pspell.so 会直接报错“no such file”。
确认系统已安装 aspell 及开发头文件
pspell 是 PHP 对 aspell 库的封装，不是纯 PHP 实现。没装底层库，编译阶段就会失败。
- Ubuntu/Debian：
sudo apt install aspell aspell-en libaspell-dev（aspell-en是英文词典，按需选语言） - macOS（Homebrew）：
brew install aspell --with-lang-en（新版 brew 默认不带词典，必须显式加--with-lang-en或类似参数） - Windows 不适用：phpenv 是 Linux/macOS 工具；Windows 用户应改用 XAMPP/WAMP 或手动编译，且需确保
aspell-15.dll在 PATH 中
用 phpenv install 时传入 --with-pspell
phpenv 的 install 命令默认不启用 pspell，必须通过环境变量注入 configure 参数：
- 先查当前可用版本：
phpenv install --list | grep "8.2"（选你要装的版本，比如8.2.20） - Linux 示例（假设 aspell 装在标准路径）：
CONFIGURE_OPTS="--with-pspell" phpenv install 8.2.20
- macOS 示例（Homebrew aspell 通常在
/opt/homebrew）：CONFIGURE_OPTS="--with-pspell=/opt/homebrew" phpenv install 8.2.20
- 如果 configure 报错 “pspell.h not found”，说明
libaspell-dev（Linux）或aspell（macOS）没装对，或头文件不在默认搜索路径
验证 pspell 是否真被编译进 PHP
别急着写 php.ini，先确认二进制里有没有这个模块：
- 切换到刚装的版本：
phpenv local 8.2.20 - 运行：
php -m | grep pspell—— 如果没输出，说明编译失败或参数没生效 - 更彻底检查：
php -i | grep -A5 "PSpell Support"，正常应显示PSpell Support => enabled - 若仍失败，翻
~/.phpenv/versions/8.2.20/var/log/php-build.log，搜pspell或configure:看 configure 命令是否真包含了--with-pspell
不需要也不应该手动加 extension=pspell.so
pspell 是编译时内置扩展（built-in），不是动态加载模块（.so/.dll）。你在 php.ini 里写 extension=pspell.so 会触发警告：PHP Warning: Unable to load dynamic library 'pspell.so'，因为根本不存在这个文件。
- 它没有独立的 so 文件，函数如
pspell_new()、pspell_check()直接链接进 PHP 主二进制 - 只要
php -m能看到pspell，就表示可用；无需任何 ini 配置 - 常见误操作：看到别人配
extension=xxx.so就照搬，但pspell属于少数几个必须编译进内核的扩展之一
最易忽略的一点：phpenv 每次 install 都是全新编译，哪怕你之前装过 8.2.19 并启用了 pspell，升级到 8.2.20 也得重来一遍 CONFIGURE_OPTS。没有“全局开关”，也没有“一键启用”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
