如何保存已从NPM下架、本地node_modules留存的NPM包

不要把包直接留在node_modules目录提交，这个目录会在依赖安装、更新时被自动覆盖/修改，长期稳定性极差，按以下步骤操作即可：

步骤1：提取本地留存的包文件 #

• 在项目根目录新建local_packages目录，和node_modules保持平级，专门存放本地化维护的第三方包。
• 进入node_modules找到对应下架包的完整目录，将目录下所有文件（包括package.json、源码、构建产物、隐藏配置文件）完整复制到local_packages/[对应包名]路径下，不要遗漏文件。
• 打开复制后包目录下的package.json，确认依赖配置、入口文件配置没有缺失，可将版本号修改为自定义标识（比如原版本为2.1.0，可改为2.1.0-local），避免后续和公网可能出现的同名包产生冲突。

步骤2：配置项目依赖指向本地包 #

• 打开项目根目录的package.json，找到依赖配置中对应包的条目，将原公网版本号替换为本地文件路径，示例：

{
  "dependencies": {
    "下架的包名": "file:./local_packages/下架的包名"
  }
}

如果原包是在devDependencies下，就放到对应节点里，不要放错依赖分类。

• 删除原node_modules下该包的旧目录，同时删除锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml）中该包的相关条目，重新执行你日常用的包安装命令（npm install/yarn/pnpm install），启动项目验证功能和之前完全一致，确认本地引用生效。

用file:协议声明的依赖，包管理器不会去公网NPM仓库查询版本，会直接使用本地路径下的文件，不会出现找不到包的安装报错。

步骤3：配置Git同步给团队成员 #

• 你项目原有.gitignore中忽略node_modules的规则不需要修改，因为我们存放包的local_packages目录不在忽略范围内，直接将local_packages/下架的包名整个目录提交到Git仓库即可。
• 团队其他成员拉取最新代码后，直接执行常规依赖安装命令，就会自动从项目内的本地路径安装该包，不需要做额外配置。

后续维护说明 #

• 你后续要更新、修复这个包的代码，直接修改local_packages下对应包的文件即可，修改完成后提交Git，团队成员拉取代码后重新执行依赖安装（使用pnpm/yarn的软链模式下修改后可直接生效）就能拿到更新版本。
• 可以在项目根目录的.npmrc中添加save-exact=true配置，避免后续执行依赖更新操作时意外把这个包的引用替换为公网版本，作为额外保险。

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