Ubuntu下Node.js环境如何配置

Ubuntu下Node.js环境配置指南

在Ubuntu系统中配置Node.js环境，可根据需求选择快速安装、特定版本安装或多版本管理三种常见方式。以下是详细步骤：

一、基础环境准备

在开始安装前，建议先更新系统软件包列表，确保后续安装过程顺利：

sudo apt update

二、方法1：使用APT包管理器快速安装（适合新手）

这是最简单的安装方式，适合不需要特定版本的用户，但默认版本可能较旧。

1. 安装Node.js和npm：

   sudo apt install nodejs npm
   

2. 验证安装：
   安装完成后，通过以下命令检查版本（若node -v未显示版本，需单独安装nodejs-legacy包）：

   node -v  # 查看Node.js版本
   npm -v   # 查看npm版本
   

三、方法2：使用NodeSource仓库安装特定版本（适合需要指定版本的用户）

若需要安装LTS版本或最新版本，可通过NodeSource仓库获取更灵活的版本选择。

1. 移除旧版本（可选）：
   若之前通过APT安装过Node.js，建议先移除：

   sudo apt remove --purge nodejs
   

2. 添加NodeSource仓库：
   以安装Node.js 18.x为例（替换18.x为所需版本，如16.x、20.x）：

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

3. 安装Node.js：

   sudo apt install -y nodejs
   

4. 验证安装：

   node -v  # 应显示安装的版本（如v18.x.x）
   npm -v   # 应显示对应的npm版本
   

四、方法3：使用nvm管理多个Node.js版本（适合需要多版本共存的用户）

若需要同时使用多个Node.js版本（如项目A用14.x，项目B用18.x），推荐使用nvm（Node Version Manager）。

1. 安装nvm：

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

   注：若使用zsh，将~/.bashrc替换为~/.zshrc。

2. 加载nvm：
   安装完成后，重新加载shell配置文件使nvm生效：

   source ~/.bashrc
   

3. 验证nvm安装：

   nvm --version  # 应显示nvm版本
   

4. 安装特定版本的Node.js：
   例如安装Node.js 16.14.0：

   nvm install 16.14.0
   

5. 切换Node.js版本：
   • 临时切换：

     nvm use 16.14.0
     

   • 设置默认版本（新终端默认使用）：

     nvm alias default 16.14.0
     

6. 查看已安装版本：

   nvm ls  # 显示所有已安装的版本，当前使用的版本前会标记">"
   

五、配置npm镜像（可选，提升下载速度）

国内用户可使用淘宝镜像加速npm包下载：

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

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

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

六、常见问题解决

• node -v无输出：若通过APT安装后node命令无效，需安装nodejs-legacy包：

  sudo apt install nodejs-legacy
  

• 权限问题：安装全局npm包时，避免使用sudo（易导致权限混乱），可通过以下命令修复：

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
  source ~/.bashrc
  

以上步骤覆盖了Ubuntu下Node.js环境配置的主要场景，可根据实际需求选择合适的方式。