<think>我们正在处理用户的问题：如何在离线
环境下
安装 Node.js 的
npm 包？
根据之前的对话历史，用户已经了解了如何在Windows上离线
安装Node.js，现在关注的是如何离线
安装npm包（即
Node.js的第三方包）。
参考引用：
引用[3]提到：
安装npm包需要网络连接，但在离线
环境下我们可以通过其他方式解决。
解决方案的核心思路：
1
. 在联网机器上下载所需的
npm包及其依赖。
2
. 将下载的包传输到离线机器。
3
. 在离线机器上
安装这些包。
具体步骤：
步骤1：在联网机器上准备
npm包
- 在联网机器上创建一个项目目录，并初始化package
.json文件（如果还没有的话）：
npm init -y
-
安装所需的包，例如要
安装express：
npm install express
- 此时，
node_modules目录和package-lock
.json文件会被创建。
- 但是，为了离线
安装，我们需要将整个
node_modules目录（包括所有依赖）打包，或者使用
npm的缓存机制。
- 方法1：直接复制
node_modules（适合小项目）
将整个项目目录（包括
node_modules）复制到离线机器。
- 方法2：使用
npm离线
安装包（推荐，利用
npm的缓存）
npm默认会将下载的包缓存到本地。我们可以获取缓存的位置，然后将缓存复制到离线机器。
查找缓存目录：
npm config get cache
通常，在Windows上默认缓存路径是：`%AppData%\
npm-cache`，在
Linux/macOS上是：`~/
.npm`。
将整个缓存目录复制到离线机器（例如，放到U盘中）。
步骤2：在离线机器上
安装npm包
- 方法1：直接使用
node_modules（无需
安装）
如果已经复制了整个
node_modules目录，那么项目可以直接运行，因为所有依赖已经存在。
- 方法2：使用缓存的包进行
安装（更灵活，适合大型项目）
将之前复制的缓存目录放到离线机器上的相同路径（例如，在Windows上放到`%AppData%\
npm-cache`），或者修改
npm的配置指向这个缓存位置。
在项目目录下（有package
.json和package-lock
.json），运行：
npm install --offline
或者，如果缓存目录不在默认位置，可以指定缓存路径：
npm install --cache path/to/cache --offline
注意：如果项目之前没有生成package-lock
.json，离线
安装可能会失败，因为package-lock
.json锁定了依赖的版本，确保与缓存中的包一致。
- 方法3：使用本地tarball文件（
.tgz）
在联网机器上，将需要的包打包成tarball文件：
npm pack <package-name>
例如：
npm pack express
这会生成一个
.tgz文件（如express-4
.18
.2
.tgz），然后复制这些文件到离线机器。
在离线机器上，可以通过以下命令
安装：
npm install path/to/express-4
.18
.2
.tgz
或者，在package
.json中指定依赖为本地路径：
"dependencies": {
"express": "file:
./path/to/express-4
.18
.2
.tgz"
}
然后运行：
npm install
步骤3：验证
安装
- 在离线机器上，进入项目目录，运行项目或检查
node_modules目录是否存在所需的包。
注意事项：
- 确保离线机器上的
Node.js和
npm版本与联网机器上的一致，以避免版本不兼容问题[^3]。
- 对于全局
安装的包，可以使用类似的方法，但需要将
npm的全局缓存复制到离线机器，并使用`
npm install -g <tarball>`或`
npm install -g --offline`（需要先配置全局缓存路径）。
- 如果包有二进制依赖（如
node-gyp编译的包），需要确保离线机器有相同的编译
环境（如Python、C++编译工具链），否则可能需要下载预编译的二进制文件。
总结：
离线
安装npm包的关键在于预先下载好所有依赖并转移到离线
环境。推荐使用
npm缓存（方法2）或tarball（方法3）的方式，这样更节省空间且易于管理。
根据用户的问题，我们提供了多种方法，用户可以根据实际情况选择。
生成相关问题：
1
. 如何更新离线
环境中的
npm包？
2
. 如何处理
npm包中的二进制依赖（如
node-sass）的离线
安装？
3
. 如何搭建一个私有的
npm镜像仓库来支持离线
环境？
注意：在回答中，我们引用了[^3]（关于注意事项中的版本兼容性），因为离线
安装同样需要注意版本问题。</think>### 如何在离线
环境下
安装 Node.js 的
npm 包
离线
安装 npm 包的核心思路是：**在联网
环境预下载所需资源，再迁移到离线
环境安装**。以下是具体步骤：
---
### 方法 1：通过 `
npm pack` + 缓存依赖（推荐）
#### 步骤 1：在联网机器操作
1
. **下载目标包及其依赖**
在项目目录执行：
```bash
npm install <package-name> #
安装目标包
npm pack <package-name> # 生成
.tgz 压缩包
```
例如
安装 `lodash`：
```bash
npm install lodash
npm pack lodash # 生成 lodash-4
.17
.21
.tgz
```
2
. **提取依赖树**
复制整个 `
node_modules` 目录和 `package-lock
.json` 文件（确保锁定依赖版本）。
3
. **备份
npm 缓存**
获取缓存路径并复制：
```bash
npm config get cache # 查看缓存路径（如 C:\Users\用户\AppData\Roaming\
npm-cache）
复制整个缓存目录
```
#### 步骤 2：在离线机器操作
1
. **迁移文件**
将以下内容复制到离线机器：
- 生成的 `
.tgz` 包文件
- `
node_modules` 目录
- `package-lock
.json`
- `
npm` 缓存目录
2
. **
安装本地包**
```bash
npm install
./lodash-4
.17
.21
.tgz # 从本地文件
安装
```
3
. **利用缓存恢复依赖**
将缓存目录放回原路径（如 `C:\Users\用户\AppData\Roaming\
npm-cache`），然后运行：
```bash
npm install --offline # 强制使用本地缓存
```
---
### 方法 2：直接复制 `
node_modules`（适合小型项目）
#### 步骤：
1
. 在联网机器
安装所需包：
```bash
npm install <package1> <package2>
```
2
. 将整个项目目录（含 `
node_modules` 和 `package
.json`）复制到离线机器。
3
. 在离线机器直接运行项目，无需
安装（依赖已完整包含）。
---
### 方法 3：搭建离线镜像仓库（企业级方案）
使用工具如 [Verdaccio](https://verdaccio
.org/) 或 [Nexus Repository](https://www
.sonatype
.com/products/nexus-repository)：
1
. 在联网
环境搭建私有仓库，同步所需包。
2
. 将仓库整体迁移到离线网络。
3
. 在离线机器配置
npm 使用该仓库：
```bash
npm config set registry http://离线仓库地址
npm install # 从本地仓库获取包
```
---
### 关键注意事项
1
. **版本一致性**
确保联网与离线机器的
Node.js 和
npm 版本完全相同[^3]。
2
. **二进制依赖处理**
对含原生编译的包（如 `
node-sass`）：
- 在联网机器执行 `
npm rebuild` 生成二进制文件
- 复制整个 `
node_modules` 到相同操作系统的离线机器
3
. **路径问题**
Windows 离线
环境需检查路径分隔符（`\` vs `/`），建议使用相对路径。
4
. **验证
安装**
在离线
环境运行：
```bash
node -e "require('<package-name>'); console
.log('成功加载！')"
```
---
### 示例：离线
安装 `express`
1
. **联网机器**：
```bash
npm install express
npm pack express # 生成 express-4
.18
.2
.tgz
cp -r
node_modules
./offline-dir
```
2
. **离线机器**：
```bash
npm install
./express-4
.18
.2
.tgz
# 或直接使用复制的
node_modules
```
> ⚠️ 提示：优先使用 `package-lock
.json` 确保依赖树一致，避免版本冲突[^3]。
---
本文详述了在Linux环境下安装Node.js和npm的步骤，包括更新软件包列表、通过NodeSource添加Node.js存储库并安装、验证安装结果。安装过程中，Node.js与npm会一同安装，完成后即可开始使用它们进行JavaScript应用开发。
订阅专栏 解锁全文
扫一扫
1882
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
