composer-patches插件支持为依赖包打补丁而不修改源码或fork仓库，需安装插件、准备标准.patch文件并配置composer.json的extra.patches字段，安装时自动应用并可verbose验证。
使用 composer-patches 插件，可以在不修改源码、不 fork 仓库的前提下，为 Composer 安装的依赖包打补丁（patch），适合修复紧急 bug、适配本地环境或等待上游合并的临时改动。
安装 composer-patches 插件
在项目根目录运行：
composer require cweagans/composer-patches
该插件会自动注册为 Composer 的插件，在每次 composer install 或 composer update 时检查并应用补丁。
准备补丁文件
补丁应为标准的 .patch 或 .diff 文件，推荐用 git diff 生成，确保路径与包解压后的相对路径一致（例如 src/Example.php，不是 vendor/vendor/name/src/Example.php）。
- 把补丁放在项目内，比如
patches/my-fix.patch - 补丁内容开头建议加上简短注释说明用途和影响范围
- 避免使用绝对路径或 git 工作区路径（如
a/src/.../b/src/...），可用--no-prefix生成更兼容的补丁
在 composer.json 中声明补丁
在 composer.json 的 extra 段中添加 patches 配置：
"extra": {
"patches": {
"monolog/monolog": {
"Fix broken handler chaining": "patches/monolog-handler-chain-fix.patch"
},
"laravel/framework": {
"Allow custom cache TTL in config": "patches/laravel-cache-ttl.patch"
}
}
}
键名是目标包的 vendor/name，值是一个对象，其中 key 是补丁描述（仅用于显示），value 是补丁文件路径（相对于 composer.json）。
验证与调试补丁是否生效
运行以下命令触发补丁应用，并观察输出：
-
composer install --verbose或composer update --verbose - 成功时会看到类似
Applying patch 'Fix broken handler chaining' to vendor/monolog/monolog - 失败时会报错（如路径不匹配、补丁冲突），可加
--no-plugins排查是否被其他插件干扰 - 补丁应用后，可直接检查
vendor/下对应文件是否变更
注意：补丁只在安装/更新时执行一次，不会覆盖已手动修改的文件；若补丁失败，Composer 会中止操作并提示错误位置。
基本上就这些。补丁机制不复杂但容易忽略路径和 git diff 选项，保持补丁轻量、可读、可撤销，是长期维护的关键。
