phpenv install 失败主因是缺失 php-build 插件或编译依赖；需先 git clone 插件并安装 autoconf、libxml2-dev 等系统依赖，再执行 phpenv rehash 确保 shim 生效。
phpenv install 命令失败：常见原因和绕过方法
直接运行 phpenv install 8.3.13 失败，大概率是因为缺少 php-build 插件——phpenv 本身不带编译能力，所有安装逻辑都由这个插件提供。
必须先手动安装插件，否则任何 install 都会报错：command not found: phpenv-install 或静默退出。
- 执行
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 确保
$(phpenv root)/plugins/php-build/bin在$PATH中（通常phpenv init已处理） - 安装前建议先
phpenv rehash，避免 shim 缓存导致命令不可见 - 若提示
autoconf、libxml2-dev等缺失，需用系统包管理器补全依赖（Ubuntu/Debian：sudo apt-get install autoconf bison libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev）
.php-version 文件不生效：路径和优先级问题
phpenv 的版本切换依赖于三个层级的配置，且有明确优先级：shell 会话 > 项目本地（.php-version） > 全局（~/.phpenv/version）。如果进项目目录后 php -v 仍显示旧版本，大概率是文件位置或内容不对。
-
.php-version必须放在项目**根目录**，不能在子目录或src/下 - 文件内容只能是纯版本号，如
8.3.13，不能带空格、注释或php-前缀 - 确认当前 shell 没有残留
PHPENV_VERSION环境变量（可用unset PHPENV_VERSION清除） - 运行
phpenv version查看实际生效的是哪一层，输出格式为8.3.13 (set by /path/to/project/.php-version)
phpenv global 和 phpenv local 冲突时谁赢？
不会“冲突”，而是严格按作用域覆盖：一旦你在某个目录下执行了 phpenv local 7.4.33，该目录及其所有子目录都会无视全局设置。但退出该目录后，自动回落到全局版本。
-
phpenv global只影响没有.php-version的路径，以及新打开的终端 -
phpenv local本质就是在当前目录写入.php-version，可被git跟踪，适合团队统一环境 - 想临时覆盖本地设置？用
phpenv shell 8.2.0，它通过设置PHPENV_VERSION环境变量实现，优先级最高，关掉终端即失效 - 误设后想清除？
phpenv local --unset删除.php-version，phpenv shell --unset清除会话变量
安装后 php -v 不变：shim 未重建或 PATH 错位
即使 phpenv install 成功，php 命令仍可能调用系统自带 PHP，说明 phpenv 的 shim 机制没接管成功。
- 每次
phpenv install后必须运行phpenv rehash，否则~/.phpenv/shims/php不会生成或更新 - 检查
which php输出是否为~/.phpenv/shims/php；如果不是，说明~/.phpenv/bin没进PATH，或顺序靠后被系统/usr/bin/php覆盖 - 在
~/.bashrc或~/.zshrc中，export PATH="$HOME/.phpenv/bin:$PATH"这行必须在eval "$(phpenv init -)"之前，否则初始化逻辑读不到 bin 目录 - macOS 用户注意：
~/.zshrc是默认配置文件，不是~/.bash_profile，别配错文件
phpenv rehash 的必要性——它不像 npm install 那样自动触发，漏掉一次，新装的 PHP 就永远“看不见”。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
