phpenv安装后command not found，需确认~/.phpenv/bin已加入PATH、正确编辑shell配置文件（如~/.bashrc或~/.zshrc）、执行eval "$(phpenv init -)"并source重载；若仍无效，检查是否遗漏php-build插件及系统编译依赖。
phpenv 能一键安装，但“一键”不等于“装完就能用”——它依赖系统基础、Shell 配置和插件补全，缺一不可。
phpenv 安装后 command not found 怎么办
这是最常见卡点：克隆完仓库、执行了 git clone，但终端仍不认识 phpenv 命令。
- 确认
~/.phpenv/bin已加入PATH：运行echo $PATH，检查输出中是否含该路径 - Shell 配置文件选错：Bash 用户写入
~/.bashrc或~/.bash_profile；Zsh 用户必须写入~/.zshrc -
eval "$(phpenv init -)"必须执行，否则 shims（代理脚本）不会生成，php命令无法被重定向到对应版本 - 改完配置后别忘了重载：
source ~/.bashrc（或对应文件），而不是只开新终端——某些终端不会自动读取 profile
phpenv install 报错“no such command”或编译失败
phpenv install 不是内置命令，它来自 php-build 插件。没装插件，就只能 phpenv versions 查已装版本，不能装新版本。
- 先装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - Ubuntu/Debian 系统需预装编译依赖：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - macOS 用户需确保 Xcode Command Line Tools 已安装：
xcode-select --install - 安装时指定版本号要精确，比如
8.3.13可行，但8.3或8会失败
切换版本后 php -v 不变？优先级和缓存问题
phpenv 通过 PATH 中的 shim（如 ~/.phpenv/shims/php）接管命令，但若系统已有其他 PHP 在 PATH 更前位置，就会绕过 phpenv。
立即学习“PHP免费学习笔记（深入）”；
- 查真实执行路径：
which php—— 正常应返回~/.phpenv/shims/php；若返回/usr/bin/php或/opt/homebrew/bin/php，说明未生效 - 执行
phpenv rehash强制刷新 shim 列表（尤其在手动增删二进制或插件后） - 本地版本（
phpenv local）优先级高于全局（phpenv global），但会被当前 shell 版本（phpenv shell）覆盖；三者冲突时以phpenv version输出为准 -
.php-version文件必须放在项目根目录，且内容仅一行、无空格、无换行符，例如：8.3.13
CI/CD 或脚本中使用 phpenv 的注意事项
自动化环境里没有交互式 Shell，eval "$(phpenv init -)" 的输出可能不含完整 shims 初始化逻辑。
- CI 中建议显式设置全局版本：
phpenv global 8.3.13 && phpenv rehash，避免依赖.php-version - 某些 CI 环境（如 GitHub Actions）默认用非登录 Shell，需在 step 中加
shell: bash -l -c启用 login 模式，否则~/.bashrc不加载 - 不要在脚本里混用
phpenv shell和phpenv local—— 前者只影响当前进程，退出即失效；后者写文件，适合长期项目 - PHP 扩展（如 xdebug）需按版本单独编译安装，
pecl install调用的是当前激活版本的phpize，切版本后务必重装
真正麻烦的不是装几个版本，而是让每个版本的 php、phpize、pecl、扩展路径、php.ini 全部对齐且不互相污染——phpenv 的隔离靠的是路径硬隔离，一旦手动生成 symlink 或修改 PATH 顺序，就容易漏掉某个环节。
