phpenv 迁移不能直接复制目录，必须重置 shim 并更新 PATH 环境变量，否则 shim 仍调用旧路径导致命令失效或版本错误。
直接说结论：phpenv 本身不绑定硬盘路径，但迁移前必须重置 shim 并更新环境变量，否则 php 命令会指向旧路径下的二进制文件，导致“版本切换失效”或“command not found”。
为什么不能直接复制 ~/.phpenv 目录就完事
phpenv 的核心机制是通过 shim（轻量级代理脚本）拦截 php、composer 等命令，并根据当前目录或全局设置动态调用对应版本的 PHP 二进制。这些 shim 文件里硬编码了 ~/.phpenv/versions/xxx/bin/php 这类绝对路径。一旦你把整个 ~/.phpenv 拷到新硬盘（比如从 /home/user/.phpenv 移到 /mnt/newdisk/home/user/.phpenv），所有 shim 仍试图加载旧路径下的 PHP，必然失败。
常见错误现象包括：
-
php -v显示旧版本，或直接报错command not found -
phpenv versions列出版本，但带*的当前版本无法执行 -
which php返回的是系统自带 PHP 路径，而非~/.phpenv/shims/php
迁移前必须停用旧环境并清理 shim
在旧系统上操作，避免残留引用：
立即学习“PHP免费学习笔记（深入）”；
- 退出所有终端窗口，确保没有活跃的 shell 会话缓存旧
PATH - 运行
phpenv rehash—— 这会清空旧的 shim，防止它们被误用 - 确认
~/.phpenv/shims目录下已无任何可执行文件（如php、php-config） - 检查
~/.bashrc或~/.zshrc中的export PATH和eval "$(phpenv init -)"行是否完整，但先别改
移动目录后必须重初始化环境变量
把 ~/.phpenv 整体复制到新位置（例如 /mnt/newdisk/home/user/.phpenv）后，关键动作不是“启动”，而是“重声明”：
- 编辑 shell 配置文件（
~/.bashrc或~/.zshrc），将原export PATH="$HOME/.phpenv/bin:$PATH"改为新路径，例如：export PATH="/mnt/newdisk/home/user/.phpenv/bin:$PATH" - 同样修改
eval "$(phpenv init -)"所在行——它本身不依赖路径，但必须确保该行在新 PATH 生效之后执行 - 运行
source ~/.bashrc（或对应配置），再执行phpenv rehash—— 这一步会重建所有 shim，且使用新路径下的版本目录 - 验证：
which php应返回/mnt/newdisk/home/user/.phpenv/shims/php，phpenv version应正常显示
额外注意：PHP 版本编译路径是否也变了
如果你用 php-build 编译过 PHP，它的安装路径默认是 ~/.phpenv/versions/x.y.z。只要 ~/.phpenv 整体移动，这个路径自然跟着变——所以不用单独处理版本目录。但要注意：
- 若曾手动指定
--prefix编译参数（如--prefix=/usr/local/php-7.4），那个路径不会随迁移自动更新，必须重新编译或软链修复 - 某些扩展（如
ioncube、opcache）的.so文件路径可能写死在php.ini里，需检查extension=行中的绝对路径 -
phpenv which php是唯一可信的路径检查方式，不要依赖php --ini输出的Loaded Configuration File是否“看起来对”
最易被忽略的一点：shell 配置文件的加载顺序。如果 ~/.profile、~/.bash_profile 和 ~/.bashrc 同时存在，而你只改了其中一个，phpenv init 可能根本没执行。务必确认当前终端实际加载的是哪个文件，并统一修改。
