Ubuntu 及 WSL 环境安装 Node.js、npm 和 Yarn 指南

Ubuntu 系统安装 Node.js、npm 和 Yarn

本文介绍在 Ubuntu 系统及 WSL 环境中安装 Node.js、npm 和 Yarn 的完整步骤，涵盖多种安装方式及常见问题解决方案。

一、安装 Node.js 和 npm

方法 1：通过 NodeSource 安装（推荐，版本新）

如需其他版本（如 18.x），替换链接中的 20.x。

验证安装：

node -v # 应输出 v20.x.x
npm -v # 应输出对应版本

添加 NodeSource 仓库（以 Node.js 20.x 为例）：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

方法 2：使用 nvm（灵活管理多版本）

安装 nvm（Node Version Manager）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc

安装指定版本的 Node.js（自动包含 npm）：

nvm install --lts # 安装最新 LTS 版本
# 或指定版本
nvm install 20.5.0

安装完成后，重启终端或运行 source ~/.bashrc。

验证安装：

node -v
npm -v

方法 3：通过 Ubuntu 官方仓库（版本较旧，不推荐）

sudo apt update
sudo apt install nodejs npm

二、安装 Yarn

方法 1：通过 npm 安装（推荐）

全局安装 Yarn：

npm install -g yarn

验证安装：

yarn --version

方法 2：通过 Yarn 官方仓库

添加 GPG 密钥和仓库：

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

安装 Yarn：

sudo apt update
sudo apt install yarn

三、配置镜像源（加速下载）

1. 配置 npm 镜像源

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

2. 配置 Yarn 镜像源

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

四、解决全局安装权限问题

如果安装全局包时出现 EACCES 权限错误，按以下步骤修复：

配置 npm 全局安装目录：

mkdir ~/.npm-global
npm config set prefix ~/.npm-global

将路径添加到环境变量：

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

五、常见问题解决

1. 安装后命令未找到（如 `node` 或 `yarn`）

原因：环境变量未生效。

解决：

source ~/.bashrc # 重新加载配置
echo $PATH # 检查路径是否包含正确目录

2. 版本冲突

如果通过 apt 和 nvm 同时安装了 Node.js，优先使用 nvm 版本：

nvm use --lts # 切换到 nvm 管理的版本

3. 彻底卸载重装

重新按上述步骤安装。

卸载 Node.js 和 npm：

sudo apt purge --auto-remove nodejs npm
rm -rf ~/.npm ~/.nvm

六、验证环境

node -v # 输出 Node.js 版本
npm -v # 输出 npm 版本
yarn -v # 输出 Yarn 版本

附：完整流程示例（推荐使用 nvm）

# 1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc

# 2. 安装 Node.js 和 npm
nvm install --lts

# 3. 安装 Yarn
npm install -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 的输出结果。

Ubuntu 及 WSL 环境安装 Node.js、npm 和 Yarn 指南

Ubuntu 系统安装 Node.js、npm 和 Yarn

一、安装 Node.js 和 npm

方法 1：通过 NodeSource 安装（推荐，版本新）

方法 2：使用 nvm（灵活管理多版本）

方法 3：通过 Ubuntu 官方仓库（版本较旧，不推荐）

二、安装 Yarn

方法 1：通过 npm 安装（推荐）

方法 2：通过 Yarn 官方仓库

三、配置镜像源（加速下载）

1. 配置 npm 镜像源

2. 配置 Yarn 镜像源

四、解决全局安装权限问题

五、常见问题解决

1. 安装后命令未找到（如 `node` 或 `yarn`）

2. 版本冲突

3. 彻底卸载重装

六、验证环境

附：完整流程示例（推荐使用 nvm）

更多推荐文章

相关免费在线工具

Ubuntu 及 WSL 环境安装 Node.js、npm 和 Yarn 指南

Ubuntu 系统安装 Node.js、npm 和 Yarn

一、安装 Node.js 和 npm

方法 1：通过 NodeSource 安装（推荐，版本新）

方法 2：使用 nvm（灵活管理多版本）

方法 3：通过 Ubuntu 官方仓库（版本较旧，不推荐）

二、安装 Yarn

方法 1：通过 npm 安装（推荐）

方法 2：通过 Yarn 官方仓库

三、配置镜像源（加速下载）

1. 配置 npm 镜像源

2. 配置 Yarn 镜像源

四、解决全局安装权限问题

五、常见问题解决

1. 安装后命令未找到（如 node 或 yarn）

2. 版本冲突

3. 彻底卸载重装

六、验证环境

附：完整流程示例（推荐使用 nvm）

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

1. 安装后命令未找到（如 `node` 或 `yarn`）