Ubuntu上Nodejs模块怎样管理

作者：袖梨 2026-07-18

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

在Ubuntu系统中，Node.js模块的管理主要依赖包管理工具，其中npm（Node Package Manager，官方默认）是最常用的选择，此外还有yarn（Facebook开发，强调速度与一致性）、**pnpm（高效节省磁盘空间）**等替代工具。以下是详细的操作流程与注意事项：

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

要管理Node.js模块，需先确保系统安装了Node.js及对应的包管理工具。常见方式如下：

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

通过Ubuntu默认仓库安装（版本可能较旧，适合追求稳定的场景）：

sudo apt updatesudo apt install nodejs npm

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

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

若需要特定版本的Node.js（如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（Node Version Manager）：

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

通过nvm use <version>可快速切换版本。

二、使用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 <module_name>
```
更新所有本地模块：更新项目node_modules中的所有模块到最新版本：
```
npm update
```

4. 卸载模块

本地卸载：从项目中移除模块，并从package.json中删除对应依赖：
```
npm uninstall <module_name>
```
全局卸载：卸载全局安装的模块：
```
sudo npm uninstall -g <module_name>
```

5. 查看模块信息

查看已安装模块：列出项目node_modules中的所有模块及其版本：
```
npm list
```
查看全局模块：列出系统全局安装的模块：
```
npm list -g --depth=0
```
搜索模块：在npm仓库中搜索指定关键词的模块：
```
npm search <keyword>
```

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 <module_name>
```
添加开发依赖：
```
yarn add <module_name> --dev
```
更新模块：更新yarn.lock并安装最新版本：
```
yarn upgrade <module_name>
```
卸载模块：
```
yarn remove <module_name>
```
查看模块：列出已安装的模块：
```
yarn list
```

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

四、使用pnpm管理模块

pnpm是高效能的包管理工具，通过硬链接和全局缓存节省磁盘空间，适合大型项目：

1. 安装pnpm

通过npm全局安装：

npm install --global pnpm

2. 常用命令

初始化项目：生成package.json文件：
```
pnpm init
```
安装模块：本地安装模块（自动添加到dependencies）：
```
pnpm add <module_name>
```
添加开发依赖：
```
pnpm add <module_name> --save-dev
```
更新模块：更新所有模块到最新版本：
```
pnpm update
```
卸载模块：
```
pnpm remove <module_name>
```
查看模块：列出已安装的模块：
```
pnpm list
```

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

五、注意事项

权限问题：本地安装模块无需sudo，全局安装需sudo（但推荐使用nvm避免权限问题）。
依赖一致性：始终通过package.json和package-lock.json（npm）、yarn.lock（yarn）、pnpm-lock.yaml（pnpm）管理依赖，避免版本冲突。
版本选择：优先使用LTS版本的Node.js，确保稳定性。
工具选择：根据项目需求选择工具（如需要速度选yarn，需要节省空间选pnpm，追求稳定选npm）。

通过以上步骤，可在Ubuntu系统上高效管理Node.js模块，确保项目依赖的可维护性与一致性。