phpenv安装后需启用shims机制才能切换php版本，否则php命令仍指向系统路径；关键在于path中包含$home/.phpenv/shims且执行eval "$(phpenv init -)"，并确认.php-version文件存在及phpenv version输出正确来源。
phpenv 安装成功后，不能直接用 php 命令切换版本——必须先启用 shims 机制，否则所有 php、phpize、pear 等命令仍走系统原路径。
为什么 php -v 没变？检查 shims 是否生效
这是最常踩的坑：PATH 和 phpenv init - 配置看似正确，但 which php 仍返回 /usr/bin/php 或 /opt/homebrew/bin/php，说明 phpenv 的 shim 没接管命令。
- 运行
phpenv init -，确认输出中包含类似export PATH="$HOME/.phpenv/shims:$PATH"的行（这是关键） - 检查你的 shell 配置文件（
~/.zshrc或~/.bashrc）是否**同时写了两行**：export PATH="$HOME/.phpenv/bin:$PATH"（让phpenv命令可用）和eval "$(phpenv init -)"（让 shims 生效） - 执行
source ~/.zshrc后，再运行which php—— 正确结果应为~/.phpenv/shims/php - 如果仍是系统路径，手动加一句
export PATH="$HOME/.phpenv/shims:$PATH"到配置文件顶部，再重载
phpenv install 失败常见原因和绕过方法
直接运行 phpenv install 8.3.13 很容易卡在依赖缺失或 configure 报错，尤其在 macOS 或较新 Linux 发行版上。
- Ubuntu/Debian 必装依赖：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev libxml2-dev libsqlite3-dev libonig-dev - macOS（Homebrew）需提前装：
brew install autoconf automake openssl@3 libxml2 sqlite3 oniguruma，并设环境变量：export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl@3 --with-sqlite3=/opt/homebrew/opt/sqlite3" - 若编译失败且不想深究，改用 prebuilt 二进制（仅限 macOS）：
brew install php@8.3，再用phpenv add /opt/homebrew/opt/php@8.3/bin/php手动注册 - 安装中途中断后，删掉
~/.phpenv/versions/8.3.13和~/.phpenv/cache/php-8.3.13.tar.xz再试，避免残留损坏缓存
项目级版本控制：靠 .php-version 文件而非命令行记忆
用 phpenv local 8.3.13 设置后，它只是在当前目录写一个 .php-version 文件。这个文件才是真实生效依据，不是命令本身。
- 该文件内容就是纯文本：
8.3.13（不能带空格、不能写成php-8.3.13） - Git 提交时建议把这个文件加入仓库，团队成员
cd进来自动切对版本；如不希望提交，加到.gitignore - 如果
cd进项目后php -v没变，先确认ls -a | grep php-version是否存在，再确认phpenv versions里是否有对应版本（带*表示当前激活） - 注意：子目录不会继承父目录的
.php-version，每个目录独立生效
全局 vs shell vs local 切换的实际影响范围
三种作用域不是“优先级高低”，而是**匹配顺序**：shell > local > global。理解这点才能避免误操作。
-
phpenv shell 7.4.33：只影响当前终端会话，关掉终端就失效；适合临时调试某个老项目 -
phpenv local 8.3.13：只影响当前目录及所有子目录（只要没被更深层的.php-version覆盖）；适合项目根目录设置 -
phpenv global 8.1.12：写入~/.phpenv/version，作为最后兜底；不要轻易设，否则新建终端默认跑旧版本 - 查看当前实际生效的是哪个：运行
phpenv version（注意是单数），它会明确告诉你来源（如8.3.13 (set by /path/to/project/.php-version)）
真正麻烦的从来不是装几个版本，而是当 php -v 和 which php 对不上、或者 phpenv versions 里有版本却切不过去时，得一层层查 shims 路径、.php-version 存在性、以及 phpenv version 的具体提示——这些细节不盯住，光反复 source 配置文件没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
