如何避免手动修改的NPM包在执行npm install后被恢复为初始状态

方案1：使用patch-package生成补丁（通用最优解） #

该工具专门用于持久化NPM包的本地修改，操作步骤如下：

• 先安装工具依赖：npm install patch-package postinstall-postinstall --save-dev
• 完成node_modules下对应包的自定义修改后，执行命令生成补丁：npx patch-package <你修改的包名>
  执行成功后项目根目录会自动生成patches文件夹，里面存储该包的修改差异文件
• 在package.json的scripts字段中新增自动应用补丁的钩子：

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

  后续所有协作者执行npm install时，都会自动应用你提交的补丁，不会覆盖修改内容。

方案2：替换依赖源为自定义修改版本 #

如果不想引入额外工具，可以直接将依赖绑定为你修改后的版本：

• 方式一：将原NPM包fork到私有的Git仓库，提交你的修改后，将package.json中对应依赖的版本号替换为你的仓库地址："<包名>": "git+<你的私有仓库地址>#<对应提交的哈希值>"
• 方式二：将修改后的包完整复制到项目内的独立文件夹（比如./local-packages/xxx包），然后将依赖地址写为本地路径："<包名>": "file:./local-packages/xxx包"，npm install时会直接读取本地文件，不会从远程拉取官方包。

避坑提示 #

• 仅在package.json中锁定依赖版本无法解决问题，每次npm install都会重新拉取对应版本的官方包覆盖node_modules内的手动修改
• 禁止直接将node_modules下修改后的包文件提交到Git仓库，会导致仓库体积大幅膨胀，后续维护风险极高

内容的提问来源于stack exchange，提问作者Sambhav Jain