离线安装npm依赖的关键是提前准备本地资源：1.用本地缓存一键安装整项目（推荐），需打包~/.npm/_cacache等缓存目录并执行npm install --offline --cache；2.用.tgz包安装单个依赖，如npm install ./deps/pkg.tgz；3.搭verdaccio私有源供团队长期使用；4.避免直接复制node_modules。

在离线环境快速安装 npm 依赖包，关键不是“断网后硬装”，而是提前把所需资源准备好，让 npm 完全从本地读取。只要路径对、版本准、依赖链完整，安装过程几乎和联网时一样快。

用本地缓存一键装全项目（推荐整项目部署）

npm 默认会把每个下载过的包（含所有子依赖）存进缓存目录：
• Linux/macOS：~/.npm/_cacache
• Windows：%AppData%\npm-cache

• 在有网机器的项目根目录执行 npm install，确保 package-lock.json 被完整解析，所有依赖进缓存
• 运行 npm config get cache 查出缓存路径，打包整个缓存文件夹（如 tar -czf npm-cache.tgz ~/.npm）
• 把压缩包拷到离线机，解压到目标路径（例如 /opt/offline-cache）
• 在离线机项目目录运行：npm install --offline --cache /opt/offline-cache

单个包用 .tgz 文件直接装（适合补漏或精确控制）

每个 npm 包本质就是一个 .tgz 压缩包，结构干净、体积小、不带多余依赖。

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

• 有网时执行 npm pack lodash，生成 lodash-4.17.21.tgz
• 或从 npmjs.org 页面点 “Download the tarball”，用 curl 下载：curl -L https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz -o lodash.tgz
• 把 .tgz 拷到离线机，比如放在 ./deps/ 目录下
• 执行：npm install ./deps/lodash-4.17.21.tgz

注意：该包若依赖其他包（如 is-number），这些依赖不会自动装，得手动一并下载安装。

搭轻量私有 registry（适合团队长期用）

用 Verdaccio 这类工具起一个本地 npm 源，一次配置，长期受益，还能缓存热门包、上传私有模块。

• 在外网打包 Verdaccio：npm pack verdaccio，连同配置文件一起移入内网
• 离线机上全局安装：npm install -g ./verdaccio-5.32.0.tgz
• 启动服务：verdaccio，确认配置中 uplinks: 已注释（防连外网）
• 切源：npm config set registry http://localhost:4873/
• 之后所有 npm install 都走本地，零网络请求

不推荐直接复制 node_modules

看似最省事，但容易出问题：

• 跨平台原生模块（如 esbuild、sharp）编译产物无法通用
• package-lock.json 中的完整性校验（integrity 字段）可能失效
• npm 内部 metadata（如 _from、_resolved）缺失，后续 install 或 update 可能失败

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南