有时候我们需要修改 node_modules 下的一些代码,但是 node_modules 不会提交到 git 仓库,改动保存不下来,怎么办呢?
这时候可以用 patch-package 这个工具。
比如我对 node_modules 下的 acorn 代码做了一些修改:
加了一个 a.js 的文件:
在项目目录下执行 npx patch-package acorn 之后,就会生成这样一个目录:
在 patches 目录下的 xx.patch 文件里记录着对这个包的改动。
这个 patches 目录是可以提交到 git 仓库的,然后再次把项目拉下来的时候,执行下 npx patch-package 就会应用这次改动。
可以把它配到 postintsll 里,每次安装完依赖自动跑。
这样能保证每次拉取下来的代码都包含了对 node_modules 的改动。
如何使用我们学会了,那它是怎么实现的呢?
探究它的实现原理要分为两各方面,一个是 patches 文件怎么生成的,一个是 patches 文件怎么被应用的。
patches 文件怎么生成的
看 patches 文件的内容就能看出来这是 git 的 diff:
确实,patch-package 就是依赖 git diff 实现的 patches 文件生成。
首先 patch-package 会创建一个临时目录:
然后在这个目录写入一个 package.json 文件,dependencies 就是命令行参数指定的包名:
我们去这个目录看一下:
确实,是有这样一个 package.json 的。
然后它会在这个目录下执行 yarn install 或者 npm install(patch-package 现在不支持 pnpm):
之后就进行 git 的 init、add、commit,生成一个基础的 commit。
然后把现在 node_modules 目录下的这个被修改过的包复制过去:
之后再 git add,然后执行 git diff,就能拿到改动的 diff:
这不就是 patches 文件的内容么:
然后写到 patches 目录即可
patches 文件的生成还是挺简单的,就是在临时目录下创建了一个基础 commit,然后把新的内容复制过去,通过 git diff 生成的 patches 内容。
那应用 patches 的内容是怎么实现的呢?
patches 如何被应用的?
我又对 acorn 目录下的文件做了些修改,生成的 patches 文件是包含了增删改的:
patches 文件里记录了对哪几行做了新增,哪几行做了删除,哪几行做了修改。
如果人工应用这个 patches 文件的话,不就是找到对应文件的对应行数,做反向的操作就可以了么?
没错,patch-package 也是这样实现的,不过是自动进行的:
它读取 patches 文件之后会进行 parse:
这个 parse 的实现就是对每一行的字符串做判断,进行不同的处理:
最终能得到一个包含 diff 信息的对象,包含了对什么文件的哪些行做了什么修改:
之后对不同的类型做不同的操作就可以了:
这样就把 patches 文件里的改动应用到了 node_modules 下的包里。
总结
当我们需要对 node_modules 下的代码做改动的时候,可以通过 patch-package xxx 生成 patches 文件,它可以被提交到 git 仓库,然后再拉下来的代码就可以通过 patch-package 来应用改动。
实现原理要分为两部分来看:
patches 文件的生成是在临时目录生成 package.json,下载依赖,生成一个 commit,然后把改动的代码复制过去,两者做 gif diff,就可以生成 patches 文件。
patches 文件的应用则是 patch-package 自己实现了它的 parse,拿到对什么文件的哪些行做什么修改的信息,之后根据不同做类型做不同的文件操作就可以了。
整体看下来,这个小工具的原理还是挺清晰的,不过 parse patch 文件那部分还是有些麻烦的,当你需要解析 git diff 信息的时候,也可以参考下它的实现。