温馨提示×

Ubuntu Nodejs如何配置环境

小樊
50
2025-10-03 10:33:40
栏目: 编程语言

Ubuntu配置Node.js环境的完整步骤

一、基础环境准备

在配置Node.js前,需确保Ubuntu系统已完成基础更新,并安装curl工具(用于下载安装脚本):

sudo apt update && sudo apt upgrade -y  # 更新系统包列表及已安装软件
sudo apt install curl -y                # 安装curl(若未安装)

二、主流安装方式选择

1. 使用NodeSource APT仓库(推荐,适合大多数用户)

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替换为所需版本号(如1816),可安装对应版本。

  • 步骤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)
    

2. 使用NVM(Node Version Manager,适合多版本管理)

若需要同时使用多个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 -vnpm -v,确认当前使用的版本正确。

3. 使用Ubuntu官方APT仓库(不推荐,版本较旧)

Ubuntu默认仓库中的Node.js版本通常滞后于最新版,仅适合对版本无要求的简单场景:

sudo apt install nodejs npm -y  # 安装Node.js及npm
node -v                         # 验证版本(可能为12.x或更低)

三、可选配置优化

1. 配置npm全局包安装路径(避免权限问题)

默认情况下,全局安装的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使配置生效。

2. 设置npm镜像源(加速下载)

国内用户可使用淘宝镜像源提高npm包下载速度:

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

验证镜像源是否设置成功:

npm config get registry  # 应显示https://registry.npmmirror.com

四、常见问题排查

  • 问题1:nodenpm命令未找到
    可能原因:PATH环境变量未包含Node.js安装路径。解决方法:

    • 若使用NVM,确保已执行source ~/.bashrc
    • 若手动安装,检查/usr/bin目录下是否有nodenpm,或手动添加路径到~/.bashrc
  • 问题2:NVM安装后不生效
    确认终端类型(bash/zsh),并执行source ~/.bashrc(bash)或source ~/.zshrc(zsh);若仍无效,重新安装NVM并确保脚本执行权限正确。

通过以上步骤,可在Ubuntu系统上完成Node.js环境的配置,并根据需求选择基础安装或多版本管理方案。

0