介绍
前端开发过程中，经常会遇到第三方开源库有 BUG 的情况，通常我们有以下处理方式
- 自己 fork 一份源码修改，修复完后就可以本地打包直接用了。如果你想分享你的研究成果给其他人，可以再传到 npm 仓库或者提交 PR 给源仓库。这种方式有个缺点，就是笔记难保持和官方库的同步。
- 等待库作者修复。这种方式不太靠谱，因为开源作者一般都会比较忙，你的需求可能不会排在前面。
有些小伙伴不知道，还有一种方案是给本地 npm 包打补丁。意思是你的项目在正常安装某个 npm 依赖的情况下，通过在项目里增加一个补丁文件，就可以将对这个 npm 包的修改持久保存到项目中。这样就能实现针对开源库的 bug 修复直接应用到项目中。
小编了解到有一个叫 patch-package 的开源库，可以轻松的做到给 node_modules 的库打补丁。接下来我们看看如何使用 patch-package ，以及使用过程中有什么问题。
如何使用 patch-package
参照官方的教程，简单几步即可快速给本地 npm 包打补丁。
- 从 node_modules 中找到 npm 依赖包的源码，修复依赖包中的错误
vim node_modules/my-package/common.js
- 运行 patch-package 创建一个 .patch 文件，.patch 文件可以自动被 npm 识别并应用
npx patch-package my-package
- 提交补丁文件就可以与您的团队共享修复了
git add patches/my-package+3.14.15.patch
git commit -m "fix common.js in my-package"
- 安装下依赖包
npm i -D patch-package
- 在 package.json 中添加一个脚本 postinstall，支持在
npm i之后就会自动执行 patch-package 将补丁应用上
"scripts": {
"postinstall": "patch-package"
}
由于小编用的 pnpm 包管理器，在执行 npx patch-package my-package时候报错了
**ERROR** No package-lock.json, npm-shrinkwrap.json, or yarn.lock file.
You must use either npm@>=5, yarn, or npm-shrinkwrap to manage this project's
dependencies.
大概意思是支持npm、yarn包管理器，不支持pnpm。
官方也确实有 bug ，截止发稿日 2022 年 6 月 18 日，这个问题还是没有被修复的。
有人已经给 patch-package 提过 bug 了，见issue :How to execute patch to dependencies in other dependencies, when using pnpm #338
不过小编能力有限，只能另辟蹊径，采取变通方案
pnpm 打补丁
pnpm包管理器下给npm依赖包打补丁的思路是，将要修复的源码文件复制出来，放到项目里，在每次执行 npm i 安装依赖之后，用nodejs脚本将修改后的文件复制到源码目录中覆盖掉源代码，实现修改代码的目的。
- 修改好node_modules中依赖包源码文件，复制到跟目录的
patches目录下
vim node_modules/my-package/common.js
cp node_modules/my-package/common.js patches/my-package
- 在项目中新建一个脚本postinstall.js，实现覆盖源代码文件的操作
copyFileSync('./patches/my-package/common.js', './node_modules/my-package/common.js');
function copyFileSync(source, target) {
var targetFile = target;
// If target is a directory, a new file with the same name will be created
if (fs.existsSync(target)) {
if (fs.lstatSync(target).isDirectory()) {
targetFile = path.join(target, path.basename(source));
}
}
fs.writeFileSync(targetFile, fs.readFileSync(source));
}
- package.json 中新增一个postinstall命令指向我们的脚本
"scripts": {
"postinstall": "node scripts/postinstall.js"
}
