Ubuntu配置Node.js环境的完整步骤
在配置Node.js前,需确保Ubuntu系统已完成基础更新,并安装curl
工具(用于下载安装脚本):
sudo apt update && sudo apt upgrade -y # 更新系统包列表及已安装软件
sudo apt install curl -y # 安装curl(若未安装)
NodeSource提供的APT仓库包含最新的稳定版Node.js,安装流程简单且版本更新及时。
步骤1:添加NodeSource仓库
以安装Node.js 20.x(当前最新LTS版本)为例,运行以下命令自动配置仓库:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
注:将
setup_20.x
中的20
替换为所需版本号(如18
、16
),可安装对应版本。
步骤2:安装Node.js及npm
执行以下命令安装Node.js(包含npm):
sudo apt install -y nodejs
步骤3:验证安装
运行以下命令检查版本,确认安装成功:
node -v # 显示Node.js版本(如v20.11.1)
npm -v # 显示npm版本(如10.5.0)
若需要同时使用多个Node.js版本(如开发时切换LTS版与最新版),NVM是最优选择。
步骤1:安装NVM
运行以下命令下载并安装NVM:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
安装完成后,重启终端或运行source ~/.bashrc
使NVM生效。
步骤2:安装Node.js
使用NVM安装最新稳定版Node.js:
nvm install --lts # 安装最新LTS版本(如v20.11.1)
或安装指定版本:
nvm install 18 # 安装Node.js 18.x
步骤3:切换/设置默认版本
若安装了多个版本,可通过以下命令切换:
nvm use 18 # 切换到Node.js 18.x
设置默认版本(新终端默认使用):
nvm alias default 18
步骤4:验证安装
运行node -v
和npm -v
,确认当前使用的版本正确。
Ubuntu默认仓库中的Node.js版本通常滞后于最新版,仅适合对版本无要求的简单场景:
sudo apt install nodejs npm -y # 安装Node.js及npm
node -v # 验证版本(可能为12.x或更低)
默认情况下,全局安装的npm包需sudo
权限,可通过以下步骤修改路径:
步骤1:创建全局安装目录
mkdir ~/.npm-global
步骤2:配置npm使用新路径
npm config set prefix '~/.npm-global'
步骤3:添加路径到环境变量
编辑~/.bashrc
文件:
nano ~/.bashrc
在文件末尾添加:
export PATH=~/.npm-global/bin:$PATH
保存后运行source ~/.bashrc
使配置生效。
国内用户可使用淘宝镜像源提高npm包下载速度:
npm config set registry https://registry.npmmirror.com
验证镜像源是否设置成功:
npm config get registry # 应显示https://registry.npmmirror.com
问题1:node
或npm
命令未找到
可能原因:PATH环境变量未包含Node.js安装路径。解决方法:
source ~/.bashrc
;/usr/bin
目录下是否有node
和npm
,或手动添加路径到~/.bashrc
。问题2:NVM安装后不生效
确认终端类型(bash/zsh),并执行source ~/.bashrc
(bash)或source ~/.zshrc
(zsh);若仍无效,重新安装NVM并确保脚本执行权限正确。
通过以上步骤,可在Ubuntu系统上完成Node.js环境的配置,并根据需求选择基础安装或多版本管理方案。