如何使用 pnpm 进行打补丁patch操作？推荐两个方法

前言

作为一个前端开发者，我们每天都在和各种各样的库和依赖打交道。node_modules 目录中存放着我们项目的各种依赖。我们有时需要对其中的一些依赖进行修改，比如修复某个 bug 或者增加某些自定义功能。这时候，给 node_modules 打补丁就显得尤为重要了。

为什么 node_modules 需要打补丁？

1. 依赖库的 Bug 修复

一些第三方库可能会有未解决的 bug，等待作者修复可能需要时间。为了不影响我们的项目进度，我们可以暂时在本地对这些库进行修复。

2. 功能增强

有时，我们可能需要在第三方库的基础上增加一些功能。这些功能可能对我们的项目非常重要，但对于社区来说并不通用。

3. 临时解决方案

在我们等待官方发布新版本或者社区提供更好的解决方案之前，我们可以通过打补丁来临时解决问题。

如何进行打补丁

方法一、使用 patch-package

patch-package 是一个常用工具，可以让你对 node_modules 中的依赖包进行修改，并生成补丁文件，以便在以后重新安装依赖时自动应用这些补丁。

1. 安装 patch-package

pnpm add patch-package postinstall-postinstall

2. 修改依赖包

1. 在 node_modules 中找到需要修改的包，并进行相应的修改。
2. 运行以下命令生成补丁文件：

npx patch-package <package-name>

例如，如果你修改了 lodash 包：

npx patch-package lodash

生成的补丁文件会保存在 patches 目录下。

更新 package.json

在 package.json 中添加以下脚本，以确保在每次安装依赖时自动应用补丁：

"scripts": {
  "postinstall": "patch-package"
}

方法二、使用 pnpm patch

如果你需要对依赖包进行更复杂的修改，可以使用 pnpm patch 命令。

创建补丁

1. 使用 pnpm patch 命令创建一个可编辑的副本：

pnpm patch

这将会打开一个临时目录，允许你对依赖包进行修改。

2. 完成修改后，运行以下命令保存补丁并更新锁文件：

pnpm patch-commit

补丁会被保存在 node_modules/.pnpm/patches 目录下，并且 pnpm-lock.yaml 会被更新以包含补丁信息。这个命令会创建一个补丁文件 antd+4.16.13.patch，并保存到 patches 目录中。

3. 应用补丁

在以后的安装过程中，pnpm 会自动应用这些补丁，你不需要额外的配置。pnpm 会自动在 package.json 中添加 pnpm.patches 字段：

{
  "pnpm": {
    "patches": {
      "[email protected]": "patches/antd+4.16.13.patch"
    }
  }
}

安装依赖

最后，我们重新安装依赖：

pnpm install

这样，pnpm 就会在安装 antd 时自动应用我们创建的补丁。

总结

通过 patch-package 和 pnpm patch，我们可以方便地对 node_modules 进行打补丁，从而在不等待官方修复或发布新版本的情况下，解决当前项目中的问题。这种方法不仅灵活，还能确保我们的项目在开发过程中保持高效和稳定。