Homestead中composer不生效主因是PHP环境错配、Packagist国内访问慢及vendor权限错误；需确认PHP版本、重装Composer、配置阿里云镜像源、修改DNS、调整vendor属主与权限，并持久化全局配置。
Homestead里composer命令不生效，先确认PHP版本和PATH
Homestead默认装了多个PHP版本（如php7.4、php8.1），但composer可能绑定在旧版本上，或者根本没走Homestead内置的PHP。执行which composer和composer --version后如果报错或显示系统全局路径（比如/usr/bin/composer），说明它没走Homestead的PHP环境。
- 进Homestead后先运行
php -v确认当前PHP版本（通常是php8.1） - 用
sudo update-alternatives --config php确保php指向Homestead管理的版本 - 重装Composer：运行
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer，强制装到系统级bin目录 - 验证：
composer --version应输出版本号，且composer diagnose不报PHP扩展缺失（尤其是openssl、mbstring）
在Homestead中运行composer install卡住或超时
Homestead虚拟机默认DNS解析慢，加上Packagist国内访问不稳定，composer install经常卡在“Loading composer repositories”或“Installing dependencies”阶段。这不是网络代理问题，而是Homestead内默认没配好镜像源和DNS缓存。
- 进Homestead后立即执行：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该镜像已停用，改用https://packagist.org+composer config -g repos.packagist composer https://packagist.org） - 更推荐直接切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 加DNS缓存：编辑
/etc/resolv.conf，把nameserver改成114.114.114.114或8.8.8.8（注意重启网络服务不持久，建议写入/etc/network/interfaces的dns-nameservers行） - 临时提速：加
--no-interaction --prefer-dist --optimize-autoloader参数，避免交互等待和源码克隆
Laravel项目vendor目录权限错误导致autoload失败
在Homestead中用composer install生成的vendor/autoload.php常因文件属主是vagrant而被Nginx/Apache以www-data身份读取失败，报Class not found或failed to open stream。
- 不要用
sudo composer install——这会让所有vendor文件属主变成root，更难处理 - 正确做法：进项目目录后，先
sudo chown -R vagrant:www-data vendor/，再chmod -R 775 vendor/ - 关键点：确保
vagrant用户在www-data组里，运行usermod -a -G www-data vagrant并退出重登 - 一劳永逸：在
Vagrantfile里加同步选项owner: "www-data"和group: "www-data"，但需配合vagrant reload --provision
Homestead升级后composer全局配置丢失
每次vagrant destroy && vagrant up重建环境，~/.composer/config.json会被清空，之前设的镜像源、auth token全没了，下次composer install又变慢或私包认证失败。
- 把全局配置导出为文件：
composer config -g --list --format=json > /home/vagrant/composer-global-config.json - 在
Vagrantfile的shell.provision里加一行：cp /home/vagrant/composer-global-config.json ~/.composer/config.json || true - 私库认证信息（如GitLab token）别硬编码进脚本，改用
composer config -g http-basic.gitlab.example.com user token后导出，再同步 - 注意：
~/.composer目录本身在vagrant reload后会保留，但config.json可能被Homestead provision脚本覆盖，所以必须显式恢复
事情说清了就结束。最关键的其实是第二步换镜像源+改DNS，90%的“卡住”问题在这儿；权限和配置持久化是后续维护才暴露的坑，但一开始不埋，后面debug成本高得多。
