安装 composer-patches 插件后，可在 Composer 更新依赖时自动为第三方包打补丁。1. 通过 composer require cweagans/composer-patches 安装插件；2. 创建 .patch 补丁文件，如使用 git diff 生成修改差异；3. 在 composer.json 的 extra.patches 中配置目标包、描述及补丁路径；4. 执行 composer install 或 update 自动应用补丁。补丁需格式正确且路径准确，版本变动可能导致应用失败，需重新生成。建议及时清理临时补丁以降低维护成本。
使用 composer-patches 插件可以让你在 Composer 安装或更新依赖时，自动为第三方包打上自定义补丁。这对于临时修复 bug、适配项目需求但又无法等待上游合并 PR 的场景非常有用。
1. 安装 composer-patches 插件
在项目根目录下运行以下命令安装插件：
composer require cweagans/composer-patches安装后，该插件会自动启用，无需手动激活。
2. 准备补丁文件
创建一个补丁文件（.patch），记录你对依赖包的修改。例如：
- 先复制一份目标依赖包（如 vendor/symfony/http-foundation）进行修改
- 使用 git 生成补丁：
将补丁文件放在项目中的任意位置，比如 patches/ 目录下。
3. 在 composer.json 中配置补丁
在项目的 composer.json 中添加 patches 配置项，指定哪个包应用哪个补丁：
{ "extra": { "patches": { "symfony/http-foundation": { "Fix for broken method": "patches/symfony-http-foundation-fix.patch" } } } }
说明：
- symfony/http-foundation 是你要打补丁的包名
- "Fix for broken method" 是补丁描述，可自定义
- 路径是相对于项目根目录的补丁文件路径
4. 应用补丁
运行以下命令重新安装或更新依赖，补丁会被自动应用：
composer install # 或 composer update如果补丁应用失败，Composer 会提示错误，你可以检查补丁内容或使用 -v 参数查看详细日志。
补丁只会应用在被锁定版本匹配的情况下。如果包版本变更导致补丁无法应用，需要重新生成补丁文件。
基本上就这些。只要补丁格式正确、路径无误，composer-patches 能稳定工作。注意定期清理或替换临时补丁，避免长期维护负担。
