Node.js / npm / pnpm

本文介绍在 Ubuntu 26.04 上安装 Node.js 运行时以及主流包管理器的使用方法。

方式一：通过 nvm 安装（推荐）

nvm（Node Version Manager）允许你安装和切换多个 Node.js 版本，是最灵活的方案：

安装 nvm


curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

重新加载 Shell 配置：


source ~/.bashrc

使用 nvm


# 查看可安装的 LTS 版本
nvm ls-remote --lts
 
# 安装最新 LTS 版本
nvm install --lts
 
# 安装指定版本
nvm install 24
nvm install 22
 
# 切换版本
nvm use 24
 
# 设置默认版本
nvm alias default 24
 
# 查看已安装版本
nvm ls
 
# 卸载版本
nvm uninstall 20

方式二：通过 fnm 安装

fnm（Fast Node Manager）是用 Rust 编写的 Node.js 版本管理器，速度更快：


# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.bashrc
 
# 安装 Node.js
fnm install --lts
fnm install 24
 
# 切换版本
fnm use 24
fnm default 24
 
# 列出已安装版本
fnm list

在 ~/.bashrc 或 ~/.zshrc 中添加自动切换支持：


eval "$(fnm env --use-on-cd)"

这样进入包含 .node-version 文件的目录时会自动切换版本。

方式三：通过 apt 安装

如果只需要单一版本，可以使用 NodeSource 官方仓库：


# 添加 NodeSource 仓库（以当前 LTS Node.js 24 为例）
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
 
# 安装 Node.js（自带 npm）
sudo apt install nodejs -y
 
# 验证
node --version
npm --version

npm 包管理器

npm 随 Node.js 一起安装，是默认的包管理器：

基本用法


# 初始化项目
npm init -y
 
# 安装依赖
npm install express
 
# 安装开发依赖
npm install --save-dev typescript
 
# 全局安装工具
npm install -g nodemon
 
# 运行脚本
npm run dev
npm start
 
# 更新依赖
npm update
npm outdated

配置国内镜像


npm config set registry https://registry.npmmirror.com

验证配置：


npm config get registry

pnpm

pnpm 使用硬链接和内容寻址存储，节省磁盘空间且安装速度更快：

安装 pnpm


# 通过 npm 安装
npm install -g pnpm
 
# 或独立安装
curl -fsSL https://get.pnpm.io/install.sh | sh -

使用 pnpm


# 初始化项目
pnpm init
 
# 安装依赖
pnpm add express
pnpm add -D typescript
 
# 安装所有依赖
pnpm install
 
# 运行脚本
pnpm dev
pnpm start
 
# 更新依赖
pnpm update
 
# 管理全局包
pnpm add -g nodemon

配置镜像


pnpm config set registry https://registry.npmmirror.com

pnpm 工作区（Monorepo）

在项目根目录创建 pnpm-workspace.yaml：


packages:
  - 'packages/*'
  - 'apps/*'


# 在指定包中安装依赖
pnpm --filter @myapp/web add react
 
# 在所有包中运行命令
pnpm -r run build

Yarn

Yarn 是另一个流行的包管理器：

安装 Yarn


# 通过 corepack 启用
# 注意：Node.js 25 起 corepack 不再随官方发行版捆绑，需先单独安装
# （Node.js 24 LTS 及更早版本仍内置 corepack，可跳过下一行）
npm install -g corepack
corepack enable
corepack prepare yarn@stable --activate
 
# 或通过 npm 安装
npm install -g yarn

使用 Yarn


# 初始化项目
yarn init -2
 
# 安装依赖
yarn add express
yarn add --dev typescript
 
# 安装所有依赖
yarn install
 
# 运行脚本
yarn dev

Corepack

Corepack 是 Node.js 的包管理器管理工具，确保项目使用指定版本的 pnpm 或 yarn。从 Node.js 25 起 corepack 不再随官方发行版捆绑，需先 npm install -g corepack；Node.js 24 LTS 及更早版本仍内置：


# Node.js 25+ 需先安装 corepack（24 LTS 及更早可跳过）
npm install -g corepack
 
# 启用 corepack
corepack enable
 
# 在 package.json 中指定包管理器
# "packageManager": "pnpm@9.15.0"

这样团队成员克隆项目后会自动使用正确版本的包管理器。

常见问题

全局安装权限问题

使用 nvm 或 fnm 安装的 Node.js 不需要 sudo 权限。如果使用 apt 安装，可能遇到权限问题：


# 修改 npm 全局安装目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

.nvmrc 文件

在项目根目录创建 .nvmrc 文件指定 Node.js 版本：


echo "24" > .nvmrc
nvm use  # 自动读取 .nvmrc

选择合适的 Node.js 版本管理器和包管理器，可以显著提升前端和后端 JavaScript 开发体验。