phpenv install 报“command not found”是因 phpenv 未加载：检查 ~/.phpenv/bin 是否在 PATH，确认配置文件（如 ~/.zshrc）已 source 且 eval "$(phpenv init -)" 在 PATH 设置之后。
phpenv install 命令为什么报错“command not found”
不是 phpenv install 本身出错，而是 phpenv 命令根本没进 shell 环境。常见原因是 PATH 没生效或初始化脚本没加载。
- 检查
~/.phpenv/bin是否在$PATH中：运行echo $PATH，确认输出里包含该路径 - 确认你编辑的是当前 shell 正在用的配置文件：
bash用户看~/.bashrc或~/.bash_profile，zsh用户必须改~/.zshrc -
eval "$(phpenv init -)"这行必须写在 PATH 设置之后，否则 shell 找不到phpenv命令来执行init - 改完配置后别只靠新开终端——直接运行
source ~/.zshrc（或对应文件）更可靠
phpenv install 8.3.13 编译失败的典型原因
php-build 插件默认不带 phpenv 一起安装，且编译 PHP 需要系统级依赖。报错常出现在 configure 阶段，比如 “openssl not found” 或 “zlib.h missing”。
- 先装插件：
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（Homebrew）：
brew install openssl@3 readline zlib curl，再导出环境变量：export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl@3 --with-zlib=/opt/homebrew/opt/zlib" - 如果提示 PEAR/PECL 不可用，需手动加
--with-pear到编译选项（修改$(phpenv root)/plugins/php-build/share/php-build/default_configure_options）
phpenv local 和 global 版本不生效？检查 which php
切换后 php -v 显示旧版本，大概率是系统自带 PHP 或其他管理器（如 brew、XAMPP）的路径压过了 phpenv 的 shim。
- 运行
which php，正常应返回类似/home/xxx/.phpenv/shims/php；若返回/usr/bin/php或/opt/homebrew/bin/php，说明 shim 没接管 - 确认
~/.phpenv/shims在$PATH中，且位置比系统路径靠前（建议放在 PATH 最前面） - 执行
phpenv rehash强制重建所有 shim 文件（尤其在新装版本或插件后） - 项目根目录下放
.php-version文件（内容仅一行，如8.3.13），比phpenv local更稳定，也方便 Git 共享
CI/CD 中 phpenv global 失效？注意 shell 类型和子 shell
GitHub Actions、GitLab CI 等默认用非交互式 shell（如 /bin/sh），而 phpenv init 输出的代码依赖 bash/zsh 特性，直接 source 会失败。
立即学习“PHP免费学习笔记（深入）”；
- 在 workflow 中显式指定 shell：
shell: bash（GitHub Actions）或shell: /bin/bash -l -c - 避免只跑
phpenv global 8.3.13，必须前置eval "$(phpenv init -)"，否则命令找不到 - CI 环境中建议用
phpenv install -s（跳过交互提示）+phpenv rehash组合，确保环境干净 - 不要依赖
phpenv local—— CI 通常没有“项目目录上下文”，global+rehash是最可控方式
shims 目录的 PATH 顺序和 CI 中 shell 的隐式降级。一旦 which php 不指向 shims，后面所有版本切换都只是幻觉。 
