phpenv迁移需手动备份~/.phpenv目录、已安装PHP版本及版本配置文件，还原时须解压至原路径、重载shell配置并执行phpenv rehash重建shims。
phpenv 本身不提供“整环境打包”功能，迁移必须手动备份配置、已安装版本、全局/局部设置三部分，缺一不可。
备份 ~/.phpenv 目录和已安装的 PHP 版本
phpenv 的核心是 ~/.phpenv 目录，但它默认不包含编译好的 PHP 二进制文件——那些实际存放在 ~/.phpenv/versions/ 下。直接复制整个 ~/.phpenv 是最稳妥的起点：
- 确保旧电脑上所有 PHP 版本都已通过
phpenv install成功安装（phpenv versions可验证） - 执行：
tar -czf phpenv_backup_$(date +%Y%m%d).tar.gz ~/.phpenv - 注意：如果使用了
php-build插件（绝大多数情况都有），它位于~/.phpenv/plugins/php-build，已在上述归档中 - 不建议只复制
versions/子目录——缺少shims/和versions/对应的元信息，可能导致phpenv rehash失败
导出当前生效的版本配置
phpenv 的版本切换状态（global / local / shell）不保存在文件系统里，而是靠 shell 环境变量或项目根目录下的 .php-version 文件驱动。必须显式记录：
- 运行
phpenv version查看当前 global 版本，记下输出（如8.1.12） - 进入每个常用项目目录，检查是否存在
.php-version文件：cat .php-version，并备份该文件 - 若用过
phpenv shell临时切换，该状态不会持久化，无需备份；但你得自己记住当时在做什么 - 别漏掉
~/.phpenv/version（global 设置文件）和任何cd ~/project && phpenv local 7.4.33生成的.php-version
还原时最关键的三步操作
在新电脑解压后，不能直接用——路径、权限、shell 初始化都需校准：
立即学习“PHP免费学习笔记（深入）”；
- 把压缩包解压到相同路径：
tar -xzf phpenv_backup_*.tar.gz -C ~（确保落回~/.phpenv） - 重新加载 shell 配置：
source ~/.zshrc或source ~/.bashrc，确认phpenv --version可执行 - 执行
phpenv rehash—— 这一步重建所有shims符号链接，否则php命令仍指向旧系统 PHP 或报 “command not found” - 检查
which php输出是否为~/.phpenv/shims/php；如果不是，说明 shell 初始化失败或有其他 PHP 路径优先级更高（比如/usr/bin/php）
容易被忽略的兼容性点
phpenv 迁移不是“复制粘贴就完事”，系统级依赖差异会立刻暴露：
- 新电脑若为 Apple Silicon（M1/M2/M3），而旧环境是 Intel Mac 或 Linux，
~/.phpenv/versions/下的二进制无法直接运行，必须重装对应版本 - Ubuntu/Debian 系统需提前装好编译依赖：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - macOS 上若用 Homebrew 安装过 OpenSSL，可能需设
export PKG_CONFIG_PATH="/opt/homebrew/opt/openssl/lib/pkgconfig"再phpenv install - 旧环境若自定义过
default_configure_options（如启用了--with-openssl），这些配置不在~/.phpenv里，得手动恢复到~/.phpenv/plugins/php-build/share/php-build/default_configure_options
