Ubuntu 系统(包括 WSL 中的 Ubuntu)安装 Node.js、npm 和 Yarn
以下是在 Ubuntu 系统(包括 WSL 中的 Ubuntu)安装 Node.js、npm 和 Yarn 的完整步骤,涵盖多种安装方式及常见问题解决方案:
一、安装 Node.js 和 npm
方法 1:通过 NodeSource 安装(推荐,版本新)
- 如果需要其他版本(如 18.x),替换链接中的
20.x。
验证安装:
node -v # 应输出 v20.x.xnpm -v # 应输出对应版本安装 Node.js 和 npm:
sudoaptinstall -y nodejs 添加 NodeSource 仓库(以 Node.js 20.x 为例):
curl -fsSL https://deb.nodesource.com/setup_20.x |sudo -E bash - 方法 2:使用 nvm(灵活管理多版本)
验证安装:
node -v npm -v 安装指定版本的 Node.js(自动包含 npm):
nvm install --lts # 安装最新 LTS 版本# 或指定版本 nvm install20.5.0 安装完成后,重启终端或运行:
source ~/.bashrc 安装 nvm(Node Version Manager):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh |bash方法 3:通过 Ubuntu 官方仓库(版本较旧,不推荐)
sudoapt update sudoaptinstall nodejs npm二、安装 Yarn
方法 1:通过 npm 安装(推荐)
验证安装:
yarn --version 全局安装 Yarn:
npminstall -g yarn方法 2:通过 Yarn 官方仓库
安装 Yarn:
sudoapt update sudoaptinstallyarn添加 GPG 密钥和仓库:
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg |sudo apt-key add - echo"deb https://dl.yarnpkg.com/debian/ stable main"|sudotee /etc/apt/sources.list.d/yarn.list 三、配置镜像源(加速下载)
1. 配置 npm 镜像源:
npm config set registry https://registry.npmmirror.com 2. 配置 Yarn 镜像源:
yarn config set registry https://registry.npmmirror.com 四、解决全局安装权限问题
如果安装全局包时出现 EACCES 权限错误,按以下步骤修复:
将路径添加到环境变量:
echo'export PATH=~/.npm-global/bin:$PATH'>> ~/.bashrc source ~/.bashrc 配置 npm 全局安装目录:
mkdir ~/.npm-global npm config set prefix ~/.npm-global 五、常见问题解决
1. 安装后命令未找到(如 node 或 yarn)
- 原因:环境变量未生效。
解决:
source ~/.bashrc # 重新加载配置echo$PATH# 检查路径是否包含正确目录2. 版本冲突
如果通过 apt 和 nvm 同时安装了 Node.js,优先使用 nvm 版本:
nvm use --lts # 切换到 nvm 管理的版本3. 彻底卸载重装
- 重新按上述步骤安装。
卸载 Node.js 和 npm:
sudoapt purge --auto-remove nodejs npmrm -rf ~/.npm ~/.nvm 六、验证环境
node -v # 输出 Node.js 版本npm -v # 输出 npm 版本yarn -v # 输出 Yarn 版本附:完整流程示例(推荐使用 nvm)
# 1. 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh |bashsource ~/.bashrc # 2. 安装 Node.js 和 npm nvm install --lts # 3. 安装 Yarnnpminstall -g yarn# 4. 配置镜像源npm config set registry https://registry.npmmirror.com yarn config set registry https://registry.npmmirror.com 如有其他问题,请提供以下信息:
- 终端执行命令的具体报错内容。
- 运行
node -v、npm -v、yarn -v的输出结果。