Linux 下安装 Node.js 超详细教程(小白友好版)

为什么要安装 Node.js?

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。有了它你就可以:

  • 跑后端代码(比如写个 API)

  • 装 npm 工具(比如前端打包工具 webpack、vite)

  • 跑很多开源工具和脚本

简单来说,不装 Node.js,很多前端和全栈工具你都用不了!


安装前先看:你是哪种 Linux?

不同发行版安装方法略有不同,最常见的几种:

发行版 包管理工具
Ubuntu / Debian apt
CentOS / RHEL / Fedora yumdnf
Arch Linux pacman

我们用 Ubuntu 举例(其它发行版也能参考)。


方法一:使用 NodeSource 官方脚本(推荐 ✅)

这个方法最简单,适用于 Ubuntu、Debian、CentOS 等。

步骤一:更新你的系统

sudo apt update && sudo apt upgrade -y

步骤二:安装 curl 工具

sudo apt install curl -y

步骤三:运行 NodeSource 安装脚本

以安装 Node.js 20 为例:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

这一步会自动配置好 Node.js 的源。

步骤四:安装 Node.js

sudo apt install -y nodejs

步骤五:验证是否安装成功

node -v
npm -v

你会看到版本号,比如:

v20.11.1
10.5.0

那就说明安装成功啦!


方法二:使用 nvm(Node 版本管理器)

如果你想安装多个版本的 Node.js,推荐使用 nvm

安装 nvm

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

安装完后,重启终端或者运行:

source ~/.bashrc

安装 Node.js

nvm install 20

安装完成后,设置默认版本:

nvm use 20
nvm alias default 20

验证

node -v
npm -v

常见问题排查

  1. node 命令找不到?

    • 检查是不是 PATH 没设置好,或者终端没重启。

  2. nvm 安装了但不起作用?

    • 确认你用了 bash/zsh,且执行了 source ~/.bashrcsource ~/.zshrc

  3. npm 装包很慢?

    • 可以用淘宝镜像:

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

写在最后

Node.js 是很多开发工具的“心脏”,不论你是做前端、后端还是玩脚本,装好它都能让你如虎添翼 。

建议新手使用 NodeSource 脚本安装法,简单无脑;进阶玩家用 nvm 灵活切换版本。