phpenv versions 输出为空的根本原因是 ~/.phpenv/versions/ 下无符合 x.y.z 命名规范且含 bin/php 的合法版本目录，或 ~/.phpenv/shims 未正确加入 path；需检查目录结构、权限、path 设置及是否在 windows 原生环境误用。

phpenv versions 输出为空，说明 shims 未生成或版本目录结构异常

根本原因不是 PHP 没装好，而是 phpenv 没法在 ~/.phpenv/versions/ 下识别出合法的已安装版本目录。shim 机制依赖每个版本目录下必须存在可执行的 bin/php 文件，且目录名需为纯版本号（如 8.2.12，不能是 php-8.2.12 或带空格）。

• 运行 ls -la ~/.phpenv/versions/，确认子目录名是否符合 X.Y.Z 格式，且每个子目录内有 bin/php
• 若目录名含前缀（如 php-7.4.33），手动重命名为 7.4.33
• 若 bin/php 不存在，说明编译安装失败，需检查 ~/.phpenv/plugins/php-build/share/php-build/log/ 下对应日志
• 确保目录权限允许当前用户读取和执行：chmod -R u+rx ~/.phpenv/versions/*

phpenv rehash 不生效，shim 文件没更新

phpenv rehash 的作用是从 ~/.phpenv/versions/*/bin/ 中扫描可执行文件，并在 ~/.phpenv/shims/ 下生成对应软链接。如果它没反应，大概率是 shims 目录没进 PATH，或者权限被阻断。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 确认 ~/.phpenv/shims 在 $PATH 最前面：echo $PATH | grep shims
• 检查 ~/.phpenv/shims/ 是否为空：ls -A ~/.phpenv/shims/；若为空，手动删掉整个 shims 目录再运行 phpenv rehash
• 某些 shell（如 zsh）可能缓存了命令路径，运行 hash -d 清除缓存后重试
• 避免用 sudo 安装 PHP 版本——会导致 bin/php 所有权为 root，rehash 时跳过该目录

php-build 安装后 phpenv 仍看不到版本

很多人误以为 php-build 装完就自动注册到 phpenv，其实它只是把编译好的 PHP 放进指定路径，不触发任何注册逻辑。必须由 phpenv 主动发现并纳入管理。

• 使用 php-build 时，目标路径必须严格指向 ~/.phpenv/versions/<version></version>，例如：php-build -i development 8.3.13 ~/.phpenv/versions/8.3.13
• 不要写成 ~/my-php/8.3.13 或 /usr/local/php/8.3.13 —— 这些路径 phpenv 根本不扫描
• 安装完成后立刻执行 phpenv rehash，再运行 phpenv versions
• 若用 phpenv install（需先启用 php-build 插件），确保插件已启用：phpenv plugins --list | grep php-build

Windows 上 phpenv 基本不可用，别白费力气

原生 phpenv（CHH/phpenv）是为 Unix-like 系统设计的，严重依赖 shims、符号链接和 exec 替换机制。Windows CMD/PowerShell 无法模拟这些行为，即使通过 WSL 安装，也常因路径分隔符、权限模型差异导致 phpenv versions 返回空。

• Windows 用户请直接放弃 phpenv，改用 windows.php.net 官方二进制包 + 手动切换 PATH，或使用 docker run --rm -v ${PWD}:/app -w /app php:8.2-cli php script.php
• WSL2 用户若坚持用 phpenv，确保安装在 Linux 子系统内（非 Windows 文件系统挂载点），且 ~/.phpenv 在 /home/xxx 下而非 /mnt/c/...
• 任何在 Windows 路径（如 C:\Users\...）里操作 phpenv 的尝试，最终都会卡在 env: php: no such file or directory

实际遇到 phpenv versions 为空时，90% 的情况是目录结构没对上或 shim 路径失效——先看 ~/.phpenv/versions/ 里有没有带 bin/php 的干净版本目录，再盯住 PATH 里有没有 shims，这两处错一个，就永远显示为空。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！