Homestead中composer install卡在“Loading composer repositories”是因默认连不上packagist.org，需立即执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾斜杠不可少），并验证输出为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，同时检查项目级repositories是否覆盖全局配置、清理缓存、更换DNS及刷新composer.lock。
Homestead里不配镜像，composer install 十有八九卡在 “Loading composer repositories” —— 不是网络差，是根本连不上 packagist.org。
进 Homestead 后第一件事：全局配阿里云镜像
Homestead 虚拟机默认用的是官方源，而国内对 packagist.org 的 DNS 解析慢、TLS 握手常失败、又没 CDN，结果就是干等不动，且不报错。必须手动切镜像：
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾斜杠不能少） - 验证是否生效：
composer config -g repo.packagist输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果提示
Permission denied，说明~/.composer/目录权限不对，运行sudo chown -R $USER:$USER ~/.composer再试 - 别用已停服的
https://packagist.phpcomposer.com，它 2023 年就下线了
为什么 composer diagnose 还显示 packagist.org？
常见错觉：配了镜像但 composer diagnose 的 “Repo” 行仍显示 https://packagist.org。这通常是因为项目级配置覆盖了全局设置：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查项目根目录下的
composer.json是否有"repositories"字段；若有，且里面写了"packagist.org": false或空对象，composer就会退回到默认源 - 临时解决：删掉
composer.json中整个"repositories"段，再运行composer clear-cache - 彻底验证：跑一次
composer update -vvv | grep -i "downloading.*mirrors\.aliyun"，看到域名才是真生效
Homestead 网络卡顿还跟 DNS 有关
即使镜像配对了，composer install 仍可能卡几秒——根源常在 DNS 解析慢。Homestead 默认用 VirtualBox 提供的 DNS，不稳定：
- 临时改 DNS：
echo "nameserver 114.114.114.114" | sudo tee /etc/resolv.conf（重启虚拟机后失效） - 持久化方案：编辑
/etc/network/interfaces，在iface eth0 inet dhcp下加一行dns-nameservers 114.114.114.114 8.8.8.8，然后sudo systemctl restart networking - 别信“加代理就能好”——镜像和 DNS 是两回事，代理解决不了本地 DNS 缓存缺失问题
项目首次 install 还卡？试试这几个参数
有些项目依赖多、包体积大，即使镜像+DNS都调好了，仍可能因交互或源码拉取慢而卡住：
- 加
--no-interaction避免等待用户输入（比如脚本里问要不要删除旧 vendor） - 加
--prefer-dist强制走压缩包而非 git clone（快 3–5 倍） - 加
--optimize-autoloader减少后续 autoload 开销，顺便触发更严格的校验，提前暴露问题 - 组合命令示例：
composer install --no-interaction --prefer-dist --optimize-autoloader
真正容易被忽略的点：Homestead 里改完镜像，composer.lock 文件若早先是在没镜像的机器上生成的，里面可能硬编码了原始 dist URL（比如指向 github.com），这种情况下仅配镜像无效，必须跑一次 composer update 才能刷新 lock 文件里的地址。
