composer status只报告文件是否被修改,不显示具体差异;加-v仅在--prefer-source安装、存在.git且系统有git命令时才输出diff,否则仅列文件名。

composer status 为什么只显示“Changed files”却不告诉你改了啥
它默认只做哈希比对,不读文件内容差异。只要 vendor/ 下某个包的任意文件内容和 composer.lock 中记录的原始 checksum(dist)或 Git commit hash(source)不一致,就标为 modified —— 但不会指出是哪行变了、是新增还是删了。这跟 git status 的语义不同,它不追踪变更类型,只回答“是否被动过”。
加 -v 参数后依然看不到 diff?检查这三个前提
composer status -v 能输出真实 diff 的前提是:
- 该包是以
--prefer-source方式安装的(即带.git目录),否则压根没 git 历史可比 -
vendor/{vendor}/{package}/.git目录存在且完整(有些包在 source 模式下仍会删掉 .git,比如部分 Laravel 衍生包) - 系统 PATH 中有可用的
git命令,且当前用户有权限执行git diff
如果任一条件不满足,-v 也只会重复列出文件名,不会报错,容易误以为“功能失效”。
status 显示 modified,但你确定没动过 vendor?这些情况也会触发
常见非人为改动场景:
- Symfony/Laravel 等框架在首次运行时自动生成缓存文件(如
vendor/symfony/cache/Adapter/PhpFilesAdapter.php),这类文件通常不在composer.lock的哈希覆盖范围内,但会被status误判为 modified - IDE(如 PHPStorm)自动格式化了整个
vendor/目录,尤其当项目设置里启用了 “Reformat code on save” 且作用域没排除 vendor - 执行过
composer install --no-scripts,导致某些包的post-install-cmd(如生成 autoload 文件、编译配置)没跑,后续再运行脚本时写入新文件,被识别为“多出来的东西” - Git 忽略规则(
.gitignore)没覆盖vendor/**/*,而你又把vendor/提交进了仓库,本地 checkout 切换分支时污染了文件状态
想真正校验文件完整性?别只靠 status
composer status 是轻量级快照比对,适合日常巡检;但要确认 vendor 是否被篡改,得用更严格的手段:
- 启用实验性命令:
COMPOSER_EXPERIMENTAL=1 composer verify-checksums --strict,它会逐个计算vendor/下源文件的 SHA256 并与composer.lock中的dist.sha256字段比对 —— 这才是防篡改的底线 - 注意它跳过三类东西:
path类型依赖、autoload_*.php等生成文件、以及--prefer-source安装的包(因无 dist.sha256) - 如果你的 CI 流程里要求“零容忍修改”,建议把
verify-checksums --strict加进部署前检查,而不是只信status的 clean 输出
真正麻烦的不是 status 报错,而是它报 clean 却行为异常——这时候问题大概率在环境变量、opcache、或 config 缓存,跟 vendor 文件完整性无关。











