phpenv install 卡在 downloading 是因 php-build 默认从 php.net 下载源码，国内访问慢；应替换为清华等镜像源、预置缓存包或安装 build-essential 等编译依赖。
phpenv 本身不负责下载 PHP 源码，真正卡住的环节是 php-build 插件在编译安装时从官方源拉取 PHP 源码包。默认走 php.net，国内直连通常超时或极慢——这不是 phpenv 的问题，而是底层构建逻辑没换镜像。
为什么 phpenv install 总是卡在 downloading…
执行 phpenv install 8.1.17 时，实际是由 php-build 调用 wget 或 curl 去下载 https://www.php.net/distributions/php-8.1.17.tar.xz。这个地址在国内解析慢、连接不稳定，且无 CDN 加速。
替换 php-build 镜像源（最有效）
修改定义文件是最直接、兼容性最好的方式：
- 找到对应版本定义文件：
~/.phpenv/plugins/php-build/share/php-build/definitions/8.1.17 - 把里面类似
https://www.php.net/distributions/php-8.1.17.tar.xz的 URL 替换成清华镜像地址：https://mirrors.tuna.tsinghua.edu.cn/php/distributions/php-8.1.17.tar.xz - 保存后重试
phpenv install 8.1.17，下载速度会从“几 KB/s”跃升至 “2–5 MB/s”
其他常用镜像地址：
- 阿里云：
https://npm.taobao.org/mirrors/php/distributions/ - 腾讯云：
https://mirrors.cloud.tencent.com/php/distributions/
手动下载 + 放入缓存目录（免等待）
如果连镜像源也偶尔不稳定，可跳过自动下载流程：
- 手动下载 tar.xz 包（比如从清华镜像站），确保文件名完全一致：
php-8.1.17.tar.xz - 放入
php-build缓存目录：mkdir -p ~/.phpenv/cache && cp php-8.1.17.tar.xz ~/.phpenv/cache/ - 再运行
phpenv install 8.1.17，它会优先检查~/.phpenv/cache，命中即跳过网络请求
安装前必须装的依赖（否则卡在 configure 阶段）
下载完成≠能编译成功。Ubuntu/Debian 系统常见缺失项：
-
build-essential（gcc、make 等） -
libssl-dev（OpenSSL 支持） -
libxml2-dev（DOM/SimpleXML 扩展依赖） -
libsqlite3-dev（PDO SQLite 支持） -
zlib1g-dev（压缩支持）
一条命令装齐：sudo apt-get install -y build-essential libssl-dev libxml2-dev libsqlite3-dev zlib1g-dev
phpenv 的安装和配置本身很快，真正的耗时黑洞永远在「下载 PHP 源码」和「本地编译」两个环节。镜像源 + 缓存 + 依赖预装，三者缺一不可——漏掉任意一个，都可能让你在终端前干等十分钟。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
