Linux 平台安装 Node.js

本文介绍如何在 Linux 系统上安装 Node.js 运行环境。根据不同发行版提供多种安装方式。

方式一：使用 NodeSource 仓库安装（推荐 Debian/Ubuntu）

NodeSource 提供了最新的 Node.js 版本，安装简单且方便后续更新：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash
sudo apt-get install -y nodejs

上述命令会：

- 添加 NodeSource 官方仓库到系统软件源

- 安装 Node.js v20.x LTS 版本（包含 npm）

### 验证安装

node -v

预期输出：v20.x.x

npm -v

预期输出：`10.x.x`

[截图：NodeSource 安装命令执行输出]

## 方式二：使用 nvm 安装（多版本管理）
nvm（Node Version Manager）是最灵活的 Node.js 版本管理工具，推荐需要管理多个版本的开发者使用：

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

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

source ~/.bashrc

如果你的默认 shell 是 zsh，则运行：

source ~/.zshrc

然后安装 Node.js：

nvm install --lts

安装完成后，可以使用以下命令查看所有已安装的版本：

nvm ls

切换版本：

nvm use 20

**💡 提示** nvm 安装不需要 sudo 权限，所有文件都在用户主目录下，非常适合没有 root 权限的服务器环境。

## 方式三：其他发行版

### Fedora / RHEL / CentOS

Fedora

sudo dnf install -y nodejs

RHEL/CentOS (需要启用 Node.js 模块)

sudo dnf module install -y nodejs:20

Arch Linux / Manjaro

sudo pacman -S nodejs npm

## 常见问题

### 安装时需要 sudo 权限吗？
使用 NodeSource 或系统包管理器安装时需要 sudo 权限。使用 nvm 安装则不需要，所有文件都位于用户主目录 `~/.nvm` 下。

### 如何升级到最新版？

使用 NodeSource

sudo apt-get update sudo apt-get upgrade nodejs

使用 nvm

nvm install --lts nvm alias default node

npm 安装全局包时权限错误

使用系统包管理器安装的 Node.js，可能需要 sudo 才能安装全局包。推荐改用 nvm 来避免权限问题：

nvm install --lts

**🚀 下一步** Node.js 安装完成后，你可以前往「CC-Switch」工具页面进行快速配置。