phpenv官方项目地址是https://gitcode.com/gh_mirrors/ph/phpenv，需用git clone命令下载至~/.phpenv，不可直接下载zip包或在windows原生环境使用。
phpenv 官方项目地址和下载方式
目前 phpenv 的权威源码托管在 GitCode，地址是：https://gitcode.com/gh_mirrors/ph/phpenv。注意这不是官网（phpenv.cn 是国内一个 PHP 集成环境软件，名字相似但完全无关），它不提供图形界面、Apache 或 MySQL，纯粹是命令行版的 PHP 版本管理工具。
安装只需一行克隆命令：
git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv
别用浏览器直接下载 ZIP 包——那样无法使用 phpenv install 子命令编译安装 PHP，后续会卡在 command not found: phpenv-install。
Windows 用户别碰 phpenv，改用其他方案
phpenv 本质是 Bash 脚本工具，依赖 Unix-like 环境（如 macOS/Linux 或 WSL2）。Windows 原生 CMD/PowerShell 下运行会报错，例如：
bash: phpenv: command not found 或 eval: command not found
- 如果你在 Windows 上双击
phpEnv8.9.5-Setup.exe，那是另一个叫「phpEnv」的国产集成套件（含 Apache+MySQL+多 PHP 版本切换 UI），和phpenv没半点关系 - 它默认装在 C 盘、写死 hosts、自动启服务，不适合 CLI 开发或 Composer 项目隔离
- 真要 Windows 下管理多个 PHP 版本，推荐
laragon或手动用symfony-cli的php:list/php:server:run
初始化失败常见原因：.bash_profile 还是 .zshrc？
执行 echo 'eval "$(phpenv init -)"' >> ~/.bash_profile 后仍提示 phpenv: command not found，大概率是因为你用的是 zsh（macOS Catalina 及以后默认）。
确认当前 shell：
echo $SHELL
如果是 /bin/zsh，就该写入 ~/.zshrc 而非 ~/.bash_profile：
echo 'export PATH="$HOME/.phpenv/bin:$PATH"' >> ~/.zshrcecho 'eval "$(phpenv init -)"' >> ~/.zshrcsource ~/.zshrc
改完不 reload，phpenv 就永远找不到——这点最容易被跳过。
phpenv local 不生效？检查 .php-version 文件格式
phpenv local 8.2.18 执行后 php -v 还是旧版本，问题常出在项目根目录下的 .php-version 文件。
这个文件必须满足三个条件：
- 文件名严格为
.php-version（不能是.php_version或php-version） - 内容只能有一行，且不能带空格或换行符，例如：
8.2.18（不是v8.2.18，也不是8.2.18\n） - 文件编码必须是 UTF-8 无 BOM；用 VS Code 保存时右下角确认显示 “UTF-8”，别选 “UTF-8 with BOM”
漏掉任意一点，phpenv 都会静默忽略该文件，回退到全局版本。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
