写点什么

pnpm 中无法使用 patch-package 打补丁

作者:OpenHacker
  • 2022 年 6 月 21 日
  • 本文字数:1551 字

    阅读完需:约 5 分钟

pnpm 中无法使用 patch-package 打补丁

原文:https://lwebapp.com/zh/post/pnpm-patch-package

介绍

前端开发过程中,经常会遇到第三方开源库有 BUG 的情况,通常我们有以下处理方式


  1. 自己 fork 一份源码修改,修复完后就可以本地打包直接用了。如果你想分享你的研究成果给其他人,可以再传到 npm 仓库或者提交 PR 给源仓库。这种方式有个缺点,就是笔记难保持和官方库的同步。

  2. 等待库作者修复。这种方式不太靠谱,因为开源作者一般都会比较忙,你的需求可能不会排在前面。


有些小伙伴不知道,还有一种方案是给本地 npm 包打补丁。意思是你的项目在正常安装某个 npm 依赖的情况下,通过在项目里增加一个补丁文件,就可以将对这个 npm 包的修改持久保存到项目中。这样就能实现针对开源库的 bug 修复直接应用到项目中。


小编了解到有一个叫 patch-package 的开源库,可以轻松的做到给 node_modules 的库打补丁。接下来我们看看如何使用 patch-package ,以及使用过程中有什么问题。

如何使用 patch-package

参照官方的教程,简单几步即可快速给本地 npm 包打补丁。


  1. 从 node_modules 中找到 npm 依赖包的源码,修复依赖包中的错误


vim node_modules/my-package/common.js
复制代码


  1. 运行 patch-package 创建一个 .patch 文件,.patch 文件可以自动被 npm 识别并应用


npx patch-package my-package
复制代码


  1. 提交补丁文件就可以与您的团队共享修复了


git add patches/my-package+3.14.15.patchgit commit -m "fix common.js in my-package"
复制代码


  1. 安装下依赖包


npm i -D patch-package
复制代码


  1. 在 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'sdependencies.
复制代码


大概意思是支持 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 脚本将修改后的文件复制到源码目录中覆盖掉源代码,实现修改代码的目的。


  1. 修改好 node_modules 中依赖包源码文件,复制到跟目录的patches目录下


vim node_modules/my-package/common.jscp node_modules/my-package/common.js patches/my-package
复制代码


  1. 在项目中新建一个脚本 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));}
复制代码


  1. package.json 中新增一个 postinstall 命令指向我们的脚本


 "scripts": {    "postinstall": "node scripts/postinstall.js" }
复制代码

总结

以上就是小编在一个使用 pnpm 包管理器的项目中实现给 npm 包打补丁的方案,如果您有更好的解决思路,欢迎分享出来。

参考

用户头像

OpenHacker

关注

软件开发教程,编程入门,资源分享 2022.02.24 加入

lwebapp.com

评论

发布
暂无评论
pnpm 中无法使用 patch-package 打补丁_前端_OpenHacker_InfoQ写作社区