真正重置依赖的操作是删 vendor 和 composer.lock 后运行 composer install;composer update 不等于重置,因它仍受旧锁文件约束,不会降级、换源或丢弃缓存包。

删 composer.lock + 运行 composer install 才是真正强制重置依赖项的操作;composer update 即使加参数,也受旧锁文件约束,不算重置。
为什么 composer update 不等于重置
它只在 composer.lock 存在的前提下重新解析 composer.json 的版本范围,不会降级、不会换源、不会改变 dist/source 下载方式,更不会丢弃已缓存的包。常见现象包括:
- 换了国内镜像源,但某些包仍从
packagist.org下载(因为 lock 文件里记着旧 URL) - 本地改过某包代码,
update后被覆盖,且无提示 - 执行
composer update --with-all-dependencies后,vendor/autoload.php的符号链接行为没变
真正重置的命令组合与顺序
必须严格按以下两步执行:
-
rm -rf vendor composer.lock(Linux/macOS)或rmdir /s vendor && del composer.lock(Windows) -
composer install(不是update)
原因:install 在找不到 composer.lock 时,会从头生成全新锁文件,并强制校验 platform 配置(如 PHP 版本)、忽略缓存、不复用旧 dist 包——这才是“重装”的实质。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
--force-reinstall 是什么,什么时候用
它不是重置,而是“原地重装”:保留 composer.lock 和版本号,仅卸载再安装每个包,用于修复文件损坏、权限错乱或软链接残留。适用场景有:
- CI 构建中因
symlink()失败导致 autoload 异常 - PHP 扩展升级后,某些包的 autoloader 缓存失效
- Docker 构建后
vendor/权限混乱,php -d extension=xxx.so报类找不到
注意:--force-reinstall 是 Composer 2.x(PHP 7.4+)特性,Composer 1.x 会报 Unrecognized option 错误。
容易被忽略的副作用
重置后 vendor/bin/ 下的二进制文件路径可能变化,IDE(如 PHPStorm)的外部工具配置、Shell 的 $PATH 缓存需手动刷新;composer dump-autoload -o 必须重跑,否则类加载器可能仍引用旧路径。Windows 用户还可能遇到 Could not delete: Permission denied,这不是 Composer 问题,而是系统禁止普通用户创建符号链接,此时应确认是否启用了开发者模式或以管理员身份运行终端。










