Composer如何查看包的更新历史？了解依赖项的功能演进【维护心得】
先说一个核心事实：Composer本身并不提供包的更新历史或功能演进视图。它的核心职责是“安装哪个版本”，至于“这个版本到底改了些什么”，你得跳出Composer，去依赖项的源码仓库里找答案——无论是查看GitHub/GitLab上的CHANGELOG、Releases页面，还是直接对比Git提交差异。
composer show --all 只列版本号，不说明改了什么
运行 composer show -a vendor/package 命令，你确实能看到所有可用的版本号列表，比如 v2.8.0、v2.9.0、v3.0.0。但问题在于，它只告诉你“有什么”，绝不告诉你“变了什么”。每个版本新增了哪些API、修复了什么关键Bug、是否存在破坏性变更，这些关键信息一概欠奉。
- 输出结果是纯粹的文本列表，没有时间戳，没有变更摘要，更没有跳转链接。
- 它依赖本地的Packagist缓存，如果缓存未及时同步，你看到的版本列表可能比GitHub上实际的tag少一两个（尤其是在新版本刚发布的那几分钟）。
- 对于私有包，如果项目没有正确配置
repositories源，它根本不会出现在结果里。 - 默认情况下，那些已被标记为废弃（abandoned）的版本不会显示，但它们很可能还在你的线上环境里运行着，这一点需要警惕。
查 CHANGELOG.md 或 Releases 页面才是正解
那么，正确的路径在哪里？行业内的主流做法是直接查阅源码仓库的变更日志。绝大多数维护良好的主流包（例如 monolog/monolog、symfony/http-foundation）都会在GitHub或GitLab仓库的根目录放置一个 CHANGELOG.md 文件，或者使用平台的Releases功能来发布带有详细描述的版本。
- 首先，用
composer show vendor/package查看包的source字段。如果显示类似https://github.com/xxx/yyy.git的地址，直接打开这个URL，然后在后面加上/blob/main/CHANGELOG.md路径，或者点击仓库顶部的Releases标签页。 - 有些包的日志存放位置比较个性，可能放在
docs/CHANGELOG.md，或者用UPGRADE-*.md这类文件来分版本说明升级注意事项。 - 如果包的
composer.json里定义了homepage字段（比如指向"https://lara vel.com"），那么优先去其官方文档站寻找 “Release Notes” 或 “Changelog” 板块通常是更高效的选择。 - 值得注意的是，CHANGELOG的内容依赖于维护者的人工更新，有时可能存在滞后或遗漏；而GitHub Releases由于与Git tag强绑定，信息往往更及时、更可信。
用 git diff 查两个版本间实际代码变化
如果你追求最底层的真相，想亲眼看看代码到底哪里不一样，那么 git diff 是你的终极工具。前提是，你当初安装这个包时使用了 "prefer-source": true 配置，这样 vendor 目录下保存的就是完整的Git仓库，可以直接执行diff命令：
git -C vendor/vendor/package diff --stat v2.8.0..v2.9.0
这条命令能让你快速概览两个版本之间改动了多少文件，是否涉及公共接口的变更，以及测试用例是否有大量更新。当然，这么做有几个前提：
- 该包确实是通过Git方式发布的（
source类型，而非dist压缩包）。 - 你本地仓库已经拉取了相关的所有tag（可以通过
git fetch --tags同步）。 - 你明确知道要对比的旧版和新版版本号（这时
composer show -a列出的列表就能派上用场了）。 - 最后，diff输出的结果需要开发者自己解读，它无法自动判断这次升级是否“安全”，因此不适合直接嵌入CI流程做自动化决策。
别信 composer.lock 里的 time 字段当“发布时间”
这里有一个常见的误解：composer.lock 文件中每个包条目下都有一个 time 字段。很多人误以为这是该版本的发布时间。其实不然，这个字段记录的是你本地执行 composer update 并将该版本写入lock文件的时间，而不是包作者在GitHub上打tag发布的时间。因此，同一个项目在不同机器上生成的lock文件，这个 time 值几乎肯定不同。
想要获取可靠的发布时间，应该查询Packagist的API：curl -s "https://packagist.org/packages/vendor/package.json" | jq '.package.versions."v2.9.0".time'
这个接口返回的是UTC时间字符串，例如 "2024-09-21T15:33:02+00:00" —— 这才是包作者创建tag并推送到Packagist的真实时刻。
说到底，理解一个依赖项的功能演进，从来不是靠一两条命令拼凑出来的。它需要你主动定位到源码仓库，打开那份变更日志，对照着具体的版本号，仔细阅读那几行关于破坏性变更的说明。工具的作用，仅仅是帮你更快地找到入口，它永远无法替代你亲自阅读和理解的过程。这才是维护依赖项健康度的关键所在。
