在linux系统中搭建node.js开发环境可以根据实际需求选择不同的安装方式,不同的方式在版本管理、维护成本上存在差异,开发者可以根据自身情况选择最合适的方案。

准备工作
在开始安装之前,需要先确认当前linux系统的版本,同时保证系统已经安装了基础的编译工具和依赖包,避免后续安装过程中出现依赖缺失的问题。如果是基于Debian或Ubuntu的系统,可以执行以下命令安装基础依赖:
sudo apt update sudo apt install -y curl build-essential
如果是基于CentOS或RHEL的系统,则执行以下命令:
sudo yum groupinstall -y "Development Tools" sudo yum install -y curl
方式一:通过系统包管理器安装
这种方式适合只需要固定版本node.js,不需要频繁切换版本的场景,操作比较简单,直接通过系统自带的包管理工具即可完成安装。
Debian/Ubuntu系统安装步骤
执行以下命令即可安装node.js和对应的包管理工具npm:
sudo apt install -y nodejs npm
CentOS/RHEL系统安装步骤
首先启用NodeSource仓库,再执行安装命令:
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash - sudo yum install -y nodejs
方式二:通过nvm安装(推荐)
nvm是node.js的版本管理工具,支持在同一台设备上安装多个不同版本的node.js,并且可以快速切换版本,非常适合需要同时维护多个项目的开发者。
安装nvm
执行以下命令下载并安装nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
安装完成后,执行以下命令让nvm生效:
source ~/.bashrc
如果是使用zsh终端,则需要执行source ~/.zshrc。
使用nvm安装node.js
安装最新稳定版node.js:
nvm install stable
也可以安装指定版本的node.js,例如安装20.x版本:
nvm install 20
设置默认使用的node.js版本:
nvm alias default 20
环境验证
安装完成后,执行以下命令验证node.js和npm是否安装成功:
node -v npm -v
如果正确输出版本号,说明环境搭建成功。可以创建一个简单的测试文件验证运行效果:
// 测试node.js运行
console.log("node.js开发环境搭建成功");
将以上代码保存为test.js,执行node test.js,如果输出对应内容,说明环境可以正常运行。
常见问题排查
- 如果执行node命令提示命令不存在,检查安装步骤是否完整,nvm安装后是否执行了生效命令。
- 如果npm安装包速度慢,可以配置国内镜像源:
npm config set registry https://registry.npmmirror.com/。 - 如果需要卸载通过系统包管理器安装的node.js,执行对应的卸载命令即可,例如Debian系统执行
sudo apt remove nodejs npm。