如何使用 composer-patches 插件为依赖包打上补丁？

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 配置：

标签： php laravel js git json composer app ai 解压