安装路径必须为纯英文、无空格，否则会导致phpenv启动失败、shim失效、命令找不到；推荐路径如D:\dev\phpenv，禁用C:\Program Files\等含空格或中文的路径。
安装路径不能含中文或空格
这是最常导致启动失败、服务报错、甚至 phpenv 命令根本找不到的原因。Windows 下路径如 C:\Program Files\phpenv 或 D:\我的开发环境\phpenv 都会触发 shell 解析异常，shim 机制失效，后续所有命令（比如 phpenv install、phpenv global）都会静默失败或报错 command not found。
- ✅ 推荐路径：
D:\dev\phpenv、C:\phpenv、E:\tools\phpenv - ❌ 绝对避免：
C:\Program Files\、D:\PHP 环境\、C:\Users\张三\phpenv - 路径中出现空格时，
phpenv init生成的 shell 初始化脚本无法正确解析$HOME或$PHPENV_ROOT，导致shims目录不被加入PATH
为什么必须把 phpenv 放在用户目录或纯英文盘符根下
phpenv 的 shim 机制依赖稳定的路径解析——它会在 $PHPENV_ROOT/shims 下生成一堆软链接（如 php、phpize），这些链接指向实际版本的二进制。一旦父路径含空格或中文，Windows 的 cmd/PowerShell 会把路径截断，或 bash（Git Bash/WSL）因 quote 处理异常而跳过该目录。
- Windows 上用 Git Bash 或 WSL 时，
$HOME若是/c/Users/张三，phpenv root输出可能变成乱码路径，phpenv rehash直接失败 - 即使手动设置
PHPENV_ROOT，如果值里有中文，eval "$(phpenv init -)"中的 shell 函数定义会语法错误 - 实测：放在
C:\phpenv后，phpenv versions能正常列出，但phpenv global 8.3.13后php -v仍显示系统旧版 —— 根本原因是 shim 没生效
下载安装包时别点“推荐安装位置”
官网下载的 Windows 安装器（如 phpenv-8.9.5-setup.exe）默认会建议装到 C:\Program Files\phpenv，这个选项看起来正规，实则埋雷。安装过程不会报错，但后续你在控制面板点击“启动 Apache”，大概率看到红色状态+日志里反复出现 httpd.exe: bad user name ${APACHE_RUN_USER} 这类配置解析失败提示。
- 安装时务必手动修改路径为纯英文、无空格、非系统保护目录，例如：
D:\phpenv - 安装后立即检查快捷方式目标路径：右键桌面图标 → 属性 → “目标”，确认末尾不是带引号的长路径（如
"C:\Program Files\phpenv\phpenv.exe"） - 若已误装，不要试图移动文件夹——shim 和注册表项会失效；应卸载后重装，且勾选“清除旧配置”选项
Linux/macOS 用户注意：$HOME 路径本身也不能含空格
虽然 Linux/macOS 对路径宽容度高，但 phpenv 的初始化脚本（尤其是 phpenv init 输出的 shell 函数）仍会因 $HOME 含空格而出问题。例如用户目录名为 /home/john doe，会导致 $(phpenv root)/shims 被拆成两个参数，PATH 注入失败。
立即学习“PHP免费学习笔记（深入）”；
- 创建新用户时就规避：用户名用
johndoe，不要用john doe - 已有问题？改用
sudo adduser --disabled-password --gecos "" johndoe新建标准用户，迁移数据 - macOS 上 Homebrew 安装的
phpenv若配合php-build编译 PHP，--prefix必须是绝对路径且不含空格，否则make install后扩展加载报Unable to load dynamic library 'curl'
