用 composer update 更新包需先确认镜像生效且无项目级覆盖：检查全局及项目级 repositories 配置，清除缓存，用 --with-all-dependencies 强制更新，并注意 php 版本、锁文件与镜像同步延迟影响。
直接用 composer update 就能更新所有包，但默认走官方源，慢且常失败；换国内镜像后，命令本身不变，关键在镜像配置是否生效、是否被项目级设置覆盖。
确认当前使用的镜像源
很多人以为改了全局镜像就万事大吉，其实 composer.json 里可能有 repositories 覆盖，或项目目录下存在 composer.lock 锁定旧版本，导致 update 看似执行却没真正拉新包。
- 运行
composer config -g repo.packagist查全局镜像（如返回{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}表示阿里云镜像已设） - 进项目目录，运行
composer config repo.packagist，若输出非空，说明项目级镜像优先级更高，会覆盖全局设置 - 检查项目根目录是否有
composer.json含"repositories"字段，尤其注意是否写了"packagist.org": false却没配替代源
一键更新全部包的正确命令组合
composer update 本身不区分镜像，它只管按当前解析到的源去拉包；所谓“一键”，其实是确保镜像生效 + 清除干扰项后的干净执行。
- 先清缓存：运行
composer clear-cache，避免本地缓存旧元数据导致跳过更新 - 再强制重读配置：加
-vvv参数跑一次composer update --dry-run，看日志里Downloading https://mirrors.aliyun.com/composer/...是否出现，确认走的是镜像站 - 真正更新：用
composer update --with-all-dependencies，否则某些子依赖可能因约束未显式声明而被跳过 - 如果卡在某个包（比如
phpunit/phpunit），可临时指定镜像 URL：运行composer update phpunit/phpunit --repository=https://mirrors.aliyun.com/composer/
常见失败场景和对应解法
报错不是因为命令写错，而是环境状态不一致。比如提示 Could not fetch https://packagist.org/packages.json，说明还在尝试连官方源；或者 Package x is not found，大概率是镜像同步延迟或包被移除。
- 镜像不同步：阿里云、腾讯云等镜像通常有 1–5 分钟延迟，若某包刚发布，等几分钟再试；清华源偶尔会因上游问题短暂不可用，可临时切到
https://packagist.phpcomposer.com（已停更，仅作应急） - PHP 版本不匹配：
composer update会根据composer.json的"require": {"php": "^8.1"}过滤包版本，如果本地 PHP 是 8.0，即使镜像里有新版包也装不上 - 权限错误：Windows 下若用 Git Bash 执行，有时
composer脚本路径解析异常，改用 PowerShell 或 CMD 重试 - 锁文件冲突：删掉
composer.lock再composer install并非更新，而是重装——要更新必须用update，否则不会升级 minor/patch 版本
镜像只是加速手段，真正决定更新结果的是 composer.json 的约束范围、本地 PHP 环境、以及 lock 文件是否被意外修改。每次 update 前花 30 秒看一眼 composer show --outdated，比盲目重跑命令更省时间。
