patch-package 修改 node_modules流程以及注意点

patch-package 是 前端工程里非常常用的一个工具 ,用来 给 node_modules 里的第三方依赖打补丁(打 patch) ,并且 可被 Git 管理、可复现 。本质:diff + apply

一句话理解:

当你不得不改 npm 包源码,但又不想 fork / 不想每次重装都手动改时,用 patch-package。


使用流程:

第一步:安装补丁工具

bash 复制代码
npm install patch-package postinstall-postinstall --save-dev 

这会自动在你的 package.json 的 scripts 里加上 "postinstall": "patch-package",确保每次安装依赖都自动修复。如果没自动加入,请手动加上。

第二步:直接修改 node_modules/某个包 的源码,并运行 patch-package 包名生成补丁

bash 复制代码
npx patch-package 你的包名

# 注意:npx patch-package 后面写的是:你"修改的那个 npm 包的包名(package name)",不是文件名,也不是路径。

例如我这里修改的文件是NativeVosk.ts 文件,生成补丁的命令应该为:npx patch-package react-native-vosk

运行后,你会发现项目根目录多了一个 patches 文件夹,里面有一个 "你修改的包名"+x.x.x.patch 文件。提交代码时把这个文件也提交上去。

第三步:清理旧的构建缓存并运行

如果是普通的项目,直接删除node_modules,再执行npm i 即可。

如果是React Native 等复杂项目,需要再删除原生项目生成的android / ios 文件夹、编译缓存 (android/app/build 或 Gradle 缓存),命令如下(这里等待时间会比较长):

bash 复制代码
# 如果是React Native 项目,先执行
cd android && ./gradlew clean && cd ..

# 再重新生成原生目录
npx expo prebuild --clean

# 最后运行
npx expo run:android

最后:验证

patch 内容是否包含你的改动

随便打开 patch 文件,确认有你改的 diff

相关推荐
feixing_fx4 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx5 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
JavaGuide8 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
孟健9 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
feixing_fx9 小时前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
丘山望岳9 小时前
【开发工具】 cluade code常用快捷键
前端
小巫编程室9 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
小y的笔记10 小时前
JavaScript URL 状态同步
前端·javascript
十有八七10 小时前
手搓 Agent(五):学会翻书——RAG,先查资料再回答
前端·人工智能·后端
Swot10 小时前
产品 RAG 知识库与 AI 顾问 设计与实现
前端·后端