phpenv PATH未生效需检查三处：配置文件写入位置（Bash用~/.bash_profile或~/.bashrc，Zsh用~/.zshrc）、export PATH必须在eval "$(phpenv init -)"之前、修改后需source对应文件刷新。
phpenv 安装后 PATH 没生效？检查这三处
PATH 没加对是安装失败最常见原因，不是命令不存在，而是 shell 根本没找到 phpenv。关键不在“有没有加”，而在“加到哪个文件”和“有没有重载”。
- Bash 用户必须写入
~/.bash_profile或~/.bashrc；Zsh 用户必须写入~/.zshrc—— 写错配置文件等于白写 -
export PATH="$HOME/.phpenv/bin:$PATH"必须在eval "$(phpenv init -)"之前，顺序颠倒会导致 shims 不加载 - 改完配置后不能只靠新开终端，要执行
source ~/.bash_profile（或对应文件），否则exec $SHELL -l也未必刷新成功
phpenv install 报错“command not found: phpenv-install”
这是插件缺失的典型表现。phpenv install 功能本身不内置，依赖 php-build 插件提供编译能力。
- 手动安装插件：运行
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 确认插件目录存在且可读：
ls $(phpenv root)/plugins/应该输出php-build - 某些旧版 phpenv 需要额外初始化插件，执行
phpenv rehash后再试phpenv install 8.3.13 - 如果仍报错，检查是否误用了 Windows 版 phpEnv（图形化集成环境）——它没有
phpenv install命令，那是 macOS/Linux 的 phpenv 工具
切换 PHP 版本后 php -v 还是旧版本？
根本原因是没启用 shims 机制，或者当前目录有干扰项。phpenv 不是修改系统 PHP，而是通过符号链接动态劫持命令调用路径。
- 执行
which php，正常应返回类似/home/you/.phpenv/shims/php；如果返回/usr/bin/php，说明 shims 未生效 - 检查项目根目录是否存在
.php-version文件，它会强制覆盖全局设置；临时移除它可验证是否为此导致 - 运行
phpenv rehash强制重建所有 shims 链接，尤其在新增版本或插件后必须做 - 注意
phpenv shell 8.2.12只影响当前终端会话，关掉再开就失效；如需持久化，请用phpenv local 8.2.12（写入当前目录）或phpenv global 8.2.12（写入~/.phpenv/version）
Windows 下别混淆 phpEnv 和 phpenv
名字像但完全不是一回事：Windows 图形化工具 phpEnv（官网 phpenv.cn）是 Apache+MySQL+PHP 一体包，不带命令行多版本管理；而 phpenv 是类 rbenv 的纯 CLI 工具，仅适用于 macOS/Linux。
立即学习“PHP免费学习笔记（深入）”；
- 你在 Windows 上执行
phpenv install必然失败，因为那不是它的设计目标 - Windows 用户若真需多版本 PHP，推荐使用
WSL2 + phpenv，或直接用 Docker：docker run --rm -v $(pwd):/app -w /app php:8.3-cli php --version - phpEnv（Windows 版）的“多版本”指界面里点选切换，实际是预编译好多个 PHP 目录，切换时替换
php.exe路径，不涉及 PATH 动态重定向
路径设置的核心不在“怎么写”，而在“谁在读、何时读、读到了没”。很多问题卡在 which php 没指向 shims 目录，而不是安装步骤本身漏了哪一步。
