根本原因是Vagrant默认box未预装Composer，需在虚拟机内手动安装官方版本；共享文件夹I/O性能差导致安装慢或超时，应移至本地路径并配置镜像源；autoload失效多因同步延迟或配置错误，需手动执行dump-autoload -o并检查路径格式。
Composer命令在Vagrant里执行不了，提示“command not found”
根本原因是Vagrant默认box（比如ubuntu/bionic64）没预装Composer，不是路径或权限问题。得手动装，而且必须装在虚拟机内部，宿主机装了没用。
- 先
vagrant ssh进虚拟机，再运行安装命令，别在宿主机终端敲 - 推荐用官方安装方式：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"→php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 装完执行
composer --version确认，如果报Permission denied，说明/usr/local/bin没写权限，改用sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 别用
apt install composer——Ubuntu源里的版本太老（常是1.x），Laravel 9+、Symfony 6+项目会直接报错Your requirements could not be resolved
运行composer install卡住或超时
Vagrant共享文件夹（synced_folder）的I/O性能差，Composer大量读写vendor/和composer.lock时会明显变慢，甚至触发GitHub API限流或超时。
- 把项目目录移到虚拟机本地路径（如
/home/vagrant/myapp），而不是/vagrant共享目录下再运行composer install - 加
--no-interaction --no-progress参数减少输出开销：composer install --no-interaction --no-progress - 如果提示
Failed to download ... Could not resolve host: api.github.com，检查虚拟机网络：运行ping -c 3 api.github.com，不通就改Vagrantfile里的config.vm.network "private_network"为"public_network"或检查宿主机代理设置 - 国内用户务必配镜像源：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该源已停，改用https://mirrors.aliyun.com/composer/）
composer dump-autoload不生效，类还是找不到
常见于修改了autoload配置或新增了PSR-4命名空间后，但vendor/autoload.php没更新。Vagrant里尤其容易因文件同步延迟导致自动加载映射失效。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 别依赖IDE或编辑器自动触发，手动跑
composer dump-autoload -o（-o生成优化后的classmap，比默认PSR-4映射快） - 确认
composer.json里autoload段写法正确，例如"App\": "app/"末尾不能漏掉/，否则dump-autoload会静默忽略 - 如果用的是Vagrant + NFS共享，
vendor/目录可能被宿主机杀毒软件锁定，导致autoload_classmap.php写入失败——关掉Windows Defender实时防护或Mac上mds_stores进程再试
不同PHP版本下composer update失败
Vagrant里常通过php7.4/php8.1切换PHP版本，但Composer本身会绑定当前php命令指向的版本，而composer.json里"php": "^8.1"这类约束会强制校验，不匹配就中断。
- 先查当前PHP版本：
php -v，再查Composer用的PHP：composer --version输出里带PHP版本号，两者必须一致 - 如果用了
update-alternatives切PHP，记得同步更新php软链：sudo update-alternatives --config php，然后hash -r刷新shell命令缓存 - 避免在
composer.json里硬写"php": ">=8.1.0 ——Vagrant box升级PHP小版本后容易突然失败，放宽成<code>"php": "^8.1"更稳妥 - 升级PHP后务必删掉
vendor/和composer.lock重来，残留的旧扩展（如ext-mbstring未启用）会导致update中途报requirement missing
最麻烦的其实是共享文件夹和PHP扩展的隐式耦合：你以为改了php.ini就生效了，其实Vagrant里opcache.enable=1这种配置在NFS挂载下可能被绕过，结果composer dump-autoload -o生成的优化文件压根没加载。遇到类找不到，先php --ini确认加载的是哪个配置，再php -m | grep opcache看扩展真开了没。
