phpenv init报错主因是phpenv未正确加载至shell路径或克隆不完整；需确认~/.phpenv/bin在$PATH中、检查bin/phpenv存在、Zsh用户改配.zshrc、初始化命令须独占一行。
phpenv init - 命令执行失败的常见原因和修复方法
执行 eval "$(phpenv init -)" 报错（比如提示 phpenv: no such command 'init'），基本说明 phpenv 二进制没加载到 shell，或克隆不完整。
- 确认
~/.phpenv/bin确实在$PATH开头：运行echo $PATH | grep phpenv，如果没输出，说明路径没生效或顺序靠后 - 检查克隆是否完整：进入
~/.phpenv，运行ls -la bin/，必须看到phpenv可执行文件；若缺失，重新git clone并确保网络通畅（镜像地址已更新为https://gitcode.com/gh_mirrors/ph/phpenv） - Zsh 用户注意：部分系统默认用 Zsh，但配置写进了
~/.bashrc，需改写到~/.zshrc并执行source ~/.zshrc - 初始化命令必须在 shell 配置里“单独一行”，不能和
export PATH=...合并在同一行，否则eval会解析失败
phpenv local 7.4.33 不生效？检查这三处
执行 phpenv local 7.4.33 后 php -v 仍显示旧版本，问题通常不在命令本身，而在环境链路断点。
-
.php-version文件必须存在于当前目录（不是父目录），且内容**不能带空格或换行符**：用cat .php-version | od -c查看是否含\r（Windows 换行） - 确认该版本已安装：运行
phpenv versions，目标版本前应有空格或星号；若未列出，先phpenv install 7.4.33，再phpenv rehash - 检查是否有更高优先级的版本覆盖：运行
phpenv version，它会明确告诉你当前版本来源是local、global还是shell；如果显示global，说明phpenv global设置了其他值，需先phpenv global --unset或覆盖为所需版本
phpenv install 编译失败时最该装的依赖库
phpenv install 本质是源码编译，缺依赖会导致 configure 报错（如 configure: error: openssl/ssl.h: No such file or directory）或 make 中断。不同系统依赖名不同，但核心几类逃不掉。
- Ubuntu/Debian：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev libsqlite3-dev - CentOS/RHEL：
sudo yum groupinstall "Development Tools" && sudo yum install -y openssl-devel curl-devel readline-devel sqlite-devel zlib-devel - macOS（Homebrew）：
brew install autoconf automake openssl@3 curl sqlite3 zlib，并确保export PATH="/opt/homebrew/opt/openssl@3/bin:$PATH"已加入 shell 配置 - 别跳过
libsqlite3-dev：PHP 8.1+ 默认启用 SQLite3 扩展，缺它会直接中断编译
项目级版本固化：为什么推荐 .php-version 而非 phpenv local
phpenv local 7.4.33 和手动写 .php-version 效果一样，但后者才是团队协作和 CI 环境中真正可靠的方案。
立即学习“PHP免费学习笔记（深入）”；
-
.php-version是纯文本文件，Git 可追踪、可审查、可合入主干；而phpenv local只是写文件的快捷方式，容易被忽略或遗漏 - CI 系统（如 GitHub Actions）默认不加载用户 shell 配置，
phpenv local命令可能根本不可用，但只要phpenv init正确，它就会自动读.php-version - 某些 IDE（如 PhpStorm）能识别
.php-version并自动切换解释器；而phpenv local的状态对 IDE 是黑盒 - 文件内容必须严格为版本号字符串，例如
8.1.17，多一个空格或注释都会导致解析失败
实际使用中，最易被忽略的是 phpenv rehash —— 它不是安装后执行一次就完事的命令。每次手动增删 PHP 二进制（比如装扩展、重编译）、或新增/删除版本后，都得运行它来刷新 shims。否则 php 命令仍指向旧路径。
