不能直接拷贝 ~/.phpenv 目录，因其内含硬编码的二进制路径、CPU架构依赖（如Intel/ARM不兼容）、系统库版本耦合（glibc/openssl差异）、符号链接失效及编译时configure选项绑定，导致php --version报错或composer install失败；必须重装phpenv、重建PHP版本、重装扩展并同步configure参数与.php-version声明。
phpenv 项目迁移不能直接复制整个目录，必须重装 + 重建环境 + 重装扩展，否则大概率 php --version 报错或 composer install 失败。
为什么不能直接拷贝 ~/.phpenv 目录
phpenv 本身只是个 shell 脚本管理器，它依赖的 PHP 二进制文件是编译安装在本地路径（如 ~/.phpenv/versions/8.1.20/bin/php）里的，这些二进制包含硬编码的库路径、libphp.so 位置、甚至 CPU 指令集（比如旧电脑是 Intel，新电脑是 Apple Silicon，直接运行会报 Bad CPU type in executable）。
- macOS 上不同芯片架构（Intel vs ARM）会导致编译产物不兼容
- Linux 不同发行版（Ubuntu vs CentOS）glibc 版本差异会让 PHP 二进制启动失败
- Windows（WSL）下路径、权限、符号链接行为与原生 Linux 不一致，
phpenv install生成的软链常失效 - 即使架构和系统一致，
openssl、zlib等系统依赖版本微小差异也会触发 configure 阶段失败
正确迁移步骤：重装 phpenv + 重建版本 + 同步扩展
核心原则：只迁移「声明」，不迁移「产物」。即保留你用过的 PHP 版本列表和扩展启用状态，其他全部重来。
- 在旧电脑上执行：
phpenv versions记下所有已安装版本（如7.4.33、8.1.20、8.2.12） - 执行：
php -m并过滤掉内置模块（core、date、json等），只保留第三方扩展名（如igbinary、redis、mongodb） - 检查项目根目录是否有
.php-version或.tool-versions（如果用 asdf 兼容模式），这是关键的版本声明文件，务必复制过去 - 新电脑先装 phpenv（推荐用 git clone 官方仓库，别用包管理器装的旧版），再逐个运行
phpenv install 8.1.20—— 这步会重新编译，耗时但安全 - 每个版本装完后，用
phpenv local 8.1.20切换，再pecl install redis igbinary重装扩展（注意 PECL 版本要匹配 PHP 小版本，如 PHP 8.1 不能装 redis 5.3.7+）
项目级依赖怎么同步才不翻车
很多人卡在 composer install 报 extension missing 或 ext-mbstring not loaded，问题不在 phpenv 本身，而在没同步 PHP 的编译选项。
立即学习“PHP免费学习笔记（深入）”；
- PHP 编译时若没加
--enable-mbstring，即使装了mbstring扩展，composer仍会拒绝运行（因 Composer 检查的是 configure 选项，不是php -m输出） - 用
php -i | grep configure查看旧环境的 configure 命令，把其中关键参数（尤其是--with-openssl、--with-curl、--enable-opcache）记下来，重装时加上：phpenv install --configure-options="--with-openssl --enable-opcache" 8.1.20 -
composer.lock必须保留，它锁定了扩展 ABI 兼容性；如果换了 PHP 大版本（如 7.4 → 8.2），需先在旧环境跑composer update --dry-run确认无破坏性变更 - 避免在新环境直接
composer global require，应统一用项目级composer.json管理 dev-tools（如phpunit、phpcs）
容易被忽略的三个细节
迁移后网站能跑不等于环境就对了。下面三点不检查，过两天就会出诡异 bug：
-
php --ini输出的Loaded Configuration File路径是否指向~/.phpenv/versions/x.x.x/etc/php.ini？如果指向系统默认路径（如/etc/php/8.1/cli/php.ini），说明 phpenv 没生效，要检查 shell 初始化脚本（~/.zshrc或~/.bash_profile）里是否漏了source ~/.phpenv/bin/phpenv.sh - 用
which php确认调用的是 phpenv 包装后的路径（形如~/.phpenv/shims/php），不是系统自带的/usr/bin/php - 某些扩展（如
apcu、opcache）需要在php.ini里显式启用，仅pecl install不够，还要确认extension=apcu.so这行没被注释，且放在[PHP]段落之后
