如何在 Ubuntu/Debian 中安装和配置 Node.js

欢迎来到8455线路检测中心技术小课堂，每天分享一个技术小知识。

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，用于构建快速、可扩展的网络应用程序。本文将详细介绍在 Ubuntu 和 Debian 系统中安装、配置和管理 Node.js 的完整流程。

1. 系统准备

更新系统包

# 更新包列表

sudo apt update

# 升级已安装的包

sudo apt upgrade -y

# 安装必要的依赖

sudo apt install curl wget git build-essential -y

检查现有 Node.js

# 检查是否已安装 Node.js

node --version

npm --version

npx --version

# 检查多个 Node 版本管理器

which node

which npm

nvm --version

fnm --version

# 如果已有旧版本，决定保留或卸载

# 方法1: 使用 nvm 管理多个版本

# 方法2: 完全卸载重新安装

2. 安装 Node.js

方法1：使用 NodeSource 仓库（推荐）

# 安装 NodeSource 脚本依赖

sudo apt install -y ca-certificates curl gnupg

# 创建 NodeSource 密钥目录

sudo mkdir -p /etc/apt/keyrings

# 下载并导入 NodeSource 密钥

curl -fsSL /gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

# 选择 Node.js 版本

NODE_MAJOR=20 # 或 18, 16, 14 等

# 添加 NodeSource 仓库

echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] /node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

# 更新包列表

sudo apt update

# 安装 Node.js

sudo apt install nodejs -y

# 验证安装

node --version

npm --version

方法2：使用 nvm（Node Version Manager）

# 安装 nvm

curl -o- /nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载 shell 配置

source ~/.bashrc

# 或

source ~/.zshrc

# 验证 nvm 安装

nvm --version

# 列出可用版本

nvm ls-remote

# 安装指定版本

nvm install 20.0.0 # 精确版本

nvm install 20 # 主要版本

nvm install lts # 最新 LTS

nvm install node # 最新稳定版

# 查看已安装版本

nvm list

nvm ls

# 切换 Node 版本

nvm use 20

nvm use 18

nvm use lts

# 设置默认版本

nvm alias default 20

方法3：从源码编译安装

# 安装编译依赖

sudo apt install python3 make gcc g++ -y

# 下载 Node.js 源码

cd /tmp

wget /dist/v20.0.0/node-v20.0.0.tar.gz

tar -xzf node-v20.0.0.tar.gz

cd node-v20.0.0

# 配置编译选项

./configure \\

--prefix=/usr/local \\

--with-intl=system-icu \\

--without-npm \\

--shared-openssl \\

--shared-zlib \\

--shared-libuv \\

--shared-nghttp2 \\

--shared-cares \\

--shared-brotli

# 编译和安装

make -j$(nproc)

sudo make install

# 安装 npm

curl -L /install.sh | sudo sh

3. 基本配置

验证安装

# 检查 Node.js 版本

node --version

# 输出: v20.0.0

# 检查 npm 版本

npm --version

# 输出: 9.0.0+

# 检查 npx

npx --version

# 检查 Node.js 环境

node -e "console.log('Node.js is working!')"

# 查看 Node.js 安装位置

which node

which npm

which npx

更新 npm

# 更新 npm 到最新版本

sudo npm install -g npm@latest

# 查看 npm 配置

npm config list

npm config ls -l

# 设置 npm 配置

npm config set registry /

npm config set save true

npm config set save-exact true

8455线路检测中心官网上拥有完善的技术支持库可供参考，大家可自行查阅，更多技术问题，可以直接咨询。同时，8455线路检测中心整理了运维必备的工具包免费分享给大家使用，需要的朋友可以直接咨询。

更多技术知识，8455线路检测中心期待与你一起探索。