必须在Vagrant虚拟机内以开发用户（如vagrant）执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，并确保~/.composer权限正确，否则因境外源访问慢、超时或TLS/DNS延迟导致失败。
直接改全局配置就行，不用动 composer.json 或重装 Composer —— 但必须在虚拟机里执行，且要确认当前用户有写权限。
为什么国内访问慢、报错或超时
Composer 默认源 https://packagist.org 位于境外，Vagrant 虚拟机（尤其是 Homestead、Drupal VM 等基于 Ubuntu 的 box）通常未预设代理或镜像，导致 composer install 卡住、composer require 报 Connection timed out 或直接失败。
- 常见错误现象：
Failed to decode response: zlib_decode(): data error、Could not fetch https://packagist.org/packages.json - 不是网络不通，而是 TLS 握手慢 + DNS 解析延迟叠加导致超时
- Vagrant 共享文件夹、NFS 挂载本身不影响 Composer 源选择，问题纯出在 HTTP 请求层
用 composer config -g 设置全局镜像
这是最稳妥的方式，影响所有项目，且不污染项目级 composer.json。注意：必须在 Vagrant 虚拟机内执行，且以实际开发用户（如 vagrant）身份运行。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进入虚拟机：
vagrant ssh - 执行命令（推荐阿里云镜像，稳定、同步及时）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应返回https://mirrors.aliyun.com/composer/ - 如果提示
Permission denied，说明~/.composer/config.json所在目录权限不对，先运行mkdir -p ~/.composer && chmod 755 ~/.composer
别用已停服的 phpcomposer.com 镜像
https://packagist.phpcomposer.com 自 2021 年起已不可用，现在执行会返回 404 或空响应，导致 composer 命令直接失败。
- 旧教程里常见的
composer config -g repo.packagist composer https://packagist.phpcomposer.com必须替换 - 清华、腾讯、华为镜像目前可用，但阿里云同步最准、延迟最低，尤其适合 Laravel / Drupal 等依赖大量包的项目
- 若需临时切回官方源调试，用
composer config -g --unset repo.packagist
Homestead 和 Drupal VM 用户要注意路径隔离
Homestead 默认把宿主机项目目录挂载到 /home/vagrant/code，Drupal VM 挂载到 /var/www/drupalvm —— 这些路径下执行 composer 命令时，用的就是虚拟机里的全局配置，和宿主机无关。
- 不要在宿主机上配镜像，那对虚拟机内 Composer 完全无效
- 如果用了
vagrant reload --provision重装环境，镜像配置不会自动恢复，得重新跑一遍composer config -g - 某些定制 box（如老版本 Homestead）可能预装了过期镜像，务必手动覆盖
镜像配置本身很简单，但容易被忽略的是执行位置和用户上下文 —— 在虚拟机里、用对用户、避开已失效地址，三者缺一不可。
