Linux 环境中 Node.js 如何进行依赖管理

云舒
云舒
发布时间:2026-08-22| 82人浏览过
原创

前言

在 Linux 环境里做 Node.js 开发,真正影响效率的往往不是写代码本身,而是依赖能不能装得稳、管得清、团队里还能保持一致。本文把 npm 和 yarn 的常见操作按实际使用顺序拆开,并结合锁文件、全局安装和协作场景做对比,帮助你快速判断该怎么上手、又该在什么情况下切换方案。

在 Linux 环境做 Node.js 开发,依赖管理通常是项目能否顺利协作、部署和迭代的第一关。本文按实际使用顺序,把 npm 和 yarn 的常见操作拆开说明,并补充两者在锁定版本、全局安装和适用场景上的差异,方便你在看完后直接判断该用哪一个、该怎么用。

为什么 Node.js 项目离不开依赖管理

Node.js 项目通常会依赖大量第三方包,包管理器负责安装、记录、更新和移除这些依赖。无论你使用 npm 还是 yarn,核心目标都一样:把项目依赖写进清单文件,并尽量保证团队成员拿到一致的运行环境。

从日常开发看,依赖管理主要围绕几件事展开:

  • 初始化项目,生成 package.json
  • 安装业务依赖和开发工具
  • 更新或卸载不再需要的包
  • 查看当前项目到底安装了哪些依赖

Linux 下用 npm 管理依赖

npm 是 Node.js 自带的官方包管理器,生态覆盖最广,也是大多数项目默认采用的方案。如果你的目标是尽快开始开发,通常从 npm 入手最直接。

展示 npm 在 Linux 环境下从安装到维护依赖的完整操作链路信息图
npm 依赖管理操作链路用一张流程图梳理 npm 的常见依赖管理动作,方便读者对照命令快速上手。

安装 Node.js 和 npm

如果系统里还没有安装 Node.js 和 npm,可以先执行下面两条命令:

sudo apt update
sudo apt install nodejs npm

安装完成后,可以再检查一下版本,确认环境已经可用。

初始化项目并生成 package.json

进入项目目录后,先执行初始化命令:

npm init -y

这会自动生成一个 package.json 文件。它既是项目的依赖清单,也保存了名称、版本等元数据。参数 -y 的作用是跳过交互式提问,直接采用默认配置。

安装依赖与全局工具

例如安装轻量级 Web 框架 Express,可以使用:

npm install express --sa ve

根据原文,这里的 --sa ve 会把依赖信息写入 package.json 的 dependencies 字段,便于后续维护和共享项目配置。

如果是像 nodemon 这类需要在终端里直接调用的工具,则更适合全局安装:

npm install -g nodemon

安装完成后,就不需要在每个项目里重复安装一次。

更新、卸载和查看依赖

随着项目迭代,依赖版本通常需要调整,npm 的常用维护命令如下:

更新依赖

npm update

它会根据 package.json 中定义的版本范围,更新到符合要求的最新版本。

卸载依赖

npm uninstall express

执行后会同步更新 package.json,把不再需要的依赖移除掉。

查看已安装的包

npm list

这条命令会列出当前项目安装的依赖和版本号。如果只想看顶层依赖,可以加上 --depth=0,输出会更简洁。

Linux 下用 yarn 管理依赖

如果你更看重安装速度,或者希望通过锁文件更严格地固定依赖版本,yarn 是常见替代方案。它和 npm 可以同时存在,不会互相排斥。

展示 yarn 的依赖锁定机制与常见命令关系的信息图
yarn 命令与锁文件关系这张图突出 yarn 的命令结构和 yarn.lock 的作用,帮助读者理解它与 npm。

先安装 yarn

使用 yarn 之前,仍然要先确保系统中已经装好了 Node.js 和 npm。随后可以直接用 npm 全局安装 yarn:

npm install -g yarn

安装后同样可以通过版本命令确认是否安装成功。

初始化项目并安装依赖

在项目目录中执行:

yarn init -y

这条命令和 npm init -y 的作用基本一致,也会生成 package.json。

安装 Express 时,yarn 的命令写法是:

yarn add express

除了把依赖写入 package.json,它还会自动生成 yarn.lock 文件,用来锁定所有依赖的精确版本。这一点在多人协作或部署环境一致性要求较高的场景里尤其有价值。

全局安装、升级和查看依赖

如果要全局安装 nodemon,可以使用:

yarn global add nodemon

这里要额外注意一点:yarn 的全局安装路径可能和 npm 不同,必要时需要检查系统环境变量。

更新依赖

yarn upgrade

它会根据 package.json 中的版本范围更新依赖,并同步更新 yarn.lock。

卸载依赖

yarn remove express

卸载后会同时更新 package.json 和 yarn.lock。

查看已安装的包

yarn list

输出会显示完整依赖树,通常比 npm list 提供更丰富的层级信息。

npm 和 yarn 怎么选

如果只看基本使用逻辑,两者差异并不大:都能初始化项目、安装依赖、升级、卸载和查看包列表。真正影响选择的,主要是默认生态、锁文件和个人使用习惯。

展示 npm 与 yarn 在默认生态、锁文件和使用场景上的简明对比信息图
npm 与 yarn 选型对比在正式选型前,可以先用这张对比图快速判断 npm 与 yarn 各自更适合什么场景。
  • 选 npm: 更接近 Node.js 默认工作流,生态最广,上手门槛低。
  • 选 yarn: 更适合重视安装效率和依赖锁定一致性的场景。
  • 团队协作: 关键不只是选哪个工具,而是项目内保持统一,避免多人混用带来锁文件和依赖状态不一致。

结语

npm 是默认且稳妥的选择,适合绝大多数 Node.js 项目;yarn 则在安装体验和锁定机制上更有吸引力。无论最终选择哪一个,先把初始化、安装、更新、卸载和查看依赖这几项基本操作跑通,项目维护成本和协作效率都会明显更可控。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。