Linux 平台安装 Node.js

本文介绍如何在 Linux 系统上安装 Node.js 环境，适用于 Ubuntu、Debian、CentOS 等主流发行版。

方法一：使用 nvm（推荐）

nvm 是跨平台的 Node.js 版本管理工具，适用于所有 Linux 发行版。

安装 nvm

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

安装完成后，重新加载 shell 配置：

source ~/.bashrc
# 或
source ~/.zshrc

安装 Node.js

# 安装最新 LTS 版本
nvm install --lts

# 设置为默认版本
nvm alias default node

验证安装

node -v
npm -v

方法二：使用系统包管理器

Ubuntu / Debian

# 添加 NodeSource 仓库（Node.js 20 LTS）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

CentOS / RHEL / Fedora

# 添加 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -

# 安装 Node.js
sudo yum install -y nodejs
# 或（Fedora）
sudo dnf install -y nodejs

Arch Linux

sudo pacman -S nodejs npm

配置 npm 镜像（加速下载）

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

权限问题处理

在 Linux 上使用 npm 全局安装包时，可能遇到权限问题。推荐的解决方案是修改 npm 全局目录：

# 创建全局目录
mkdir ~/.npm-global

# 配置 npm 使用该目录
npm config set prefix '~/.npm-global'

# 将目录添加到 PATH（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

这样就可以不使用 sudo 进行全局安装了。

验证环境

node -v    # 应输出 v20.x.x 或更高
npm -v     # 应输出 10.x.x 或更高
npx -v     # 应与 npm 版本一致