phpenv是类Unix系统下的Shell脚本工具，无Windows安装包，需Git克隆仓库、配置PATH及启用php-build插件；官网仅提供源码，安装依赖系统开发库与版本定义同步。
phpenv 不是“安装包下载型”工具，没有 Windows 那种 .exe 或 .zip 一键安装包；它本质是 Shell 脚本集合，必须通过 Git 克隆 + 环境变量配置才能用起来。 直接去 phpenv.cn 下载的“phpEnv”是另一个同名但完全无关的 Windows 图形化集成环境（含 Apache/Nginx/MySQL），和命令行版 phpenv 不兼容、不互通、不能混用。
为什么找不到 phpenv 官方安装包？
因为 phpenv 是类 Unix 系统（macOS/Linux）下的版本管理器，设计逻辑就是源码即工具：
- 它没有预编译二进制，所有 PHP 版本都由本地
php-build插件从源码编译生成 - 所谓“安装”，实际是克隆仓库到
~/.phpenv，再把它的bin/加进$PATH - 官网
phpenv.github.io和镜像源（如https://gitcode.com/gh_mirrors/ph/phpenv）只提供 Git 仓库
macOS / Linux 快速装好 phpenv 的三步实操
跳过所有图形化包装，直取可用状态：
1. 克隆仓库（推荐用 GitCode 镜像，国内更快）：git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv
立即学习“PHP免费学习笔记（深入）”；
2. 启用插件并配置 shell（注意：必须同时加 php-build，否则 phpenv install 会报错 command not found: phpenv-install）：git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build
然后往 ~/.bash_profile 或 ~/.zshrc 追加两行：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)"
3. 重载配置并验证：source ~/.zshrc（或 source ~/.bash_profile）phpenv --version 应输出类似 phpenv 1.2.4
phpenv install 报错 “No definition for 8.3.13” 怎么办？
这是最常卡住的点：默认仓库不带 PHP 版本定义文件，需手动同步 php-build 的 definitions 目录。
执行这一步补全定义：$(phpenv root)/plugins/php-build/share/php-build/definitions 目录下应有 8.3.13 这类文件 —— 如果没有，运行：cd $(phpenv root)/plugins/php-build && git pull
再试：phpenv install 8.3.13
常见失败原因还包括：
- 缺少系统依赖（如 autoconf、openssl-devel、libxml2-devel）
- macOS 上未装 Command Line Tools：xcode-select --install
- 使用了 zsh 但配置写进了 .bash_profile，导致 phpenv init 没生效
项目级版本控制：别只靠 global
phpenv global 8.3.13 是全局兜底，但实际开发中更可靠的是项目级锁定：
进入项目根目录后运行：phpenv local 8.3.13
它会在当前目录生成一个纯文本 .php-version 文件，内容就一行：8.3.13
这个文件会被 Git 跟踪，团队成员 git clone 后只要已装对应版本，php 命令就会自动指向该版本 —— 不依赖个人 global 设置，也不怕手误切错。
⚠️ 注意：.php-version 只对当前目录及子目录生效；如果子目录里另有 .php-version，会以最近的为准。
