首页 > 编程语言 >Ubuntu上Node.js模块管理教程

Ubuntu上Node.js模块管理教程

来源：互联网 2026-07-20 08:09:04

Ubuntu上Node.js模块管理主要使用npm、yarn和pnpm三种工具。npm为官方默认，yarn以速度与一致性著称，pnpm通过硬链接节省磁盘空间。需先安装Node.js，推荐使用nvm管理多版本。常用命令包括初始化、安装、更新、卸载模块，通过package.json和锁定文件确保依赖一致性。

Ubuntu上Node.js模块管理的核心工具与操作指南

在Ubuntu环境下使用Node.js，模块管理是必不可少的一环。目前主流工具包括npm（官方默认）、yarn（以速度和一致性著称）和pnpm（磁盘空间节省专家），各具特色。下面将拆解这些工具的使用流程和关键要点。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

一、前置准备：安装Node.js与包管理工具

管理模块前，需要先安装Node.js和对应的包管理工具。常见的安装方式有三种，可根据需求选择：

1. 安装Node.js与npm（官方仓库）

通过Ubuntu默认仓库安装，版本可能偏旧，但稳定性较好：

sudo apt update
sudo apt install nodejs npm

安装完成后，使用node -v和npm -v验证版本。

2. 通过NodeSource安装指定版本（推荐）

如需特定版本（如LTS），NodeSource的脚本非常方便：

# 以Node.js 18.x为例（可替换为16.x、20.x等）
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

这种方式会自动安装对应版本的npm。

3. 使用nvm管理多版本Node.js（灵活）

若需要在多个Node.js版本间切换，nvm是不二之选：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
# 安装指定版本（如18.17.1）
nvm install 18.17.1
# 设置默认版本
nvm alias default 18.17.1

通过nvm use 即可快速切换版本，非常灵活。

二、使用npm管理模块

npm是Node.js自带的包管理工具，日常的安装、更新、卸载均依赖它。

1. 初始化项目

创建package.json文件，记录项目依赖和元数据：

npm init

按提示填写项目名称、版本等信息，或使用npm init -y一步生成默认配置。

2. 安装模块

本地安装（项目依赖）：模块会安装到项目根目录的node_modules，并自动写入package.json的dependencies（生产依赖）或devDependencies（开发依赖）：
```
# 生产依赖（如express）
npm install express --save
# 开发依赖（如eslint）
npm install eslint --save-dev
```
全局安装（命令行工具）：安装到系统全局目录，通常需要sudo权限，适用于nodemon这类工具：
```
sudo npm install -g nodemon
```

3. 更新模块

更新指定模块：检查远程仓库，更新到最新兼容版本：
```
npm update 
```
更新所有本地模块：
```
npm update
```

4. 卸载模块

本地卸载：删除模块并从package.json中移除对应依赖：
```
npm uninstall 
```
全局卸载：
```
sudo npm uninstall -g 
```

5. 查看模块信息

查看已安装模块：
```
npm list
```
查看全局模块：
```
npm list -g --depth=0
```
搜索模块：在npm仓库中按关键词检索：
```
npm search 
```

6. 保存依赖到package.json

安装时带上--save（生产依赖）或--save-dev（开发依赖），模块信息会自动写入package.json，确保项目依赖可复现。

三、使用yarn管理模块

yarn由Facebook开发，早期解决了npm的性能短板，核心亮点是锁定文件（yarn.lock），能保证依赖版本一致性。

1. 安装yarn

通过npm全局安装：

npm install --global yarn

2. 常用命令

初始化项目：生成package.json和yarn.lock：
```
yarn init
```
安装模块：自动添加到dependencies：
```
yarn add 
```
添加开发依赖：
```
yarn add  --dev
```
更新模块：
```
yarn upgrade 
```
卸载模块：
```
yarn remove 
```
查看模块：
```
yarn list
```

yarn的优势在于并行安装（速度更快）、yarn.lock锁定版本（避免“幻影依赖”），以及缓存机制减少重复下载。

四、使用pnpm管理模块

pnpm是后起之秀，通过硬链接和全局缓存节省磁盘空间，特别适合大型项目。

1. 安装pnpm

同样通过npm全局安装：

npm install --global pnpm

2. 常用命令

初始化项目：
```
pnpm init
```
安装模块：自动添加到dependencies：
```
pnpm add 
```
添加开发依赖：
```
pnpm add  --save-dev
```
更新模块：
```
pnpm update
```
卸载模块：
```
pnpm remove 
```
查看模块：
```
pnpm list
```

pnpm的核心优势在于磁盘空间节省——多个项目可以共享同一个模块的硬链接，安装速度也快（并行处理依赖）。

五、注意事项

权限问题：本地安装不需要sudo，全局安装则需要。推荐使用nvm来避免权限麻烦。
依赖一致性：始终通过package.json和锁定文件（package-lock.json、yarn.lock、pnpm-lock.yaml）管理依赖，防止版本冲突。
版本选择：优先使用LTS版本的Node.js，稳定压倒一切。
工具选择：根据项目需求决定——追求速度选yarn，想省磁盘空间选pnpm，求稳就用npm。