Ubuntu安装Node.js教程-NPM淘宝镜像+Yarn安装指南

By | 最新修改:2025-04-27

前言

本文详细讲解如何在 Ubuntu 系统上安装 Node.js v22.x 版本,包含 NPM 淘宝镜像配置与 Yarn 包管理器的安装方法。通过官方源码下载、软链接创建、环境变量设置及镜像加速优化,帮助开发者高效搭建稳定高效的 JavaScript 开发环境。全文覆盖 Node.js 版本选择、依赖管理工具链配置及常见问题解决方案,特别针对境内网络环境提供镜像加速指引,适合新手与进阶开发者参考。

更多信息请浏览:

  1. Node.js 的官方网站
  2. Corepack 的 GitHub 仓库
  3. Npm 的官方网站
  4. Yarn 的官方网站
  5. Debian 和 Ubuntu 用户可在Node.js GitHub 仓库(当前稳定版)找到 Node 的最新稳定版本安装方式

Node.js 与 Yarn 包管理器 Logo


安装 Node.js v22.x

以下脚本为Ubuntu Node.js 的安装步骤。

cd /tmp
# 当前最新版本请访问 Node.js 官方网站(https://nodejs.org/zh-cn)查看
NODE_VER=22.15.0

# 此链接可能在境内无法访问
## wget --continue https://nodejs.org/dist/v${NODE_VER}/node-v${NODE_VER}-linux-x64.tar.xz

# 如果上面的链接无法到达,可选择以下的境内镜像
# 主页在 https://mirrors.ustc.edu.cn/node/
wget --continue https://mirrors.ustc.edu.cn/node/v${NODE_VER}/node-v${NODE_VER}-linux-x64.tar.xz

sudo tar Jxvf ./node-v${NODE_VER}-linux-x64.tar.xz -C /usr/local/
# 得到 /usr/local/node-v22.15.0-linux-x64 ,因为当前是 v22.15.0

rm -vf /tmp/node-v${NODE_VER}-linux-x64.tar.xz

# 创建 Node 相关的二进制文件软链接到 /usr/local/bin/,
# 好让用户能够使用 node、npm 和 yarn 等命令
sudo ln -sf  /usr/local/node-v${NODE_VER}-linux-x64/bin/* /usr/local/bin/
sudo ln -sf  /usr/local/node-v${NODE_VER}-linux-x64/bin/node /usr/local/bin/nodejs

# 将 Node 的可执行文件目录添加到用户的 PATH 环境变量中
echo "export PATH=\"\${PATH}:/usr/local/node-v${NODE_VER}-linux-x64/bin\"" >> ~/.bashrc
# 使 PATH 变量生效
source ~/.bashrc

设置 Npm 的境内镜像

# 给当前用户创建
npm config set registry http://registry.npm.taobao.org/
# 给 root 用户创建
sudo npm config set registry http://registry.npm.taobao.org/

安装 Yarn >= 4.0

启用 Corepack

Corepack 是一个实验性工具,可帮助管理包管理器的版本。

首先要启用 Corepack,它内置在 Node.js(>=16.10)二进制包中,默认是禁用的。

可通过运行以下命令来启用:

sudo corepack enable

快速切换 Yarn 版本

在 Corepack 命令执行之后,首次使用 Yarn 命令将从官方仓库下载指定的 Yarn 版本,仅须输入“Y”

# Node.js ^16.17 or >=18.6
# 安装 yarn 4+
corepack prepare yarn@stable --activate

# 给 root 用户安装 Yarn
sudo corepack prepare yarn@stable --activate

##################################################
# 安装 yarn 2+
corepack prepare yarn@2 --activate
sudo corepack prepare yarn@2 --activate

检验 Yarn 是否安装成功:

sudo yarn --version
yarn --version

更改 Yarn 版本

如果不想要最新稳定版,可以把它升级为其他版本。

此举将覆盖 corepack 的设定。

# 更改为最新版本
sudo yarn set version berry

# 更改为 v2.x.x 版本
sudo yarn set version 2

验证:

sudo yarn --version
yarn --version

总结

本文全面介绍了 Ubuntu 系统中 Node.js v22.x 的安装流程,包括官方源及 USTC 镜像下载、软链接创建和环境变量配置,同时讲解了 Npm 境内镜像设置以提升包管理速度。针对 Yarn 4.0+,通过启用 Node.js 内置的 Corepack 工具,实现了版本的便捷切换与管理,满足不同项目对包管理器的需求。


程序知路

鉴于本人的相关知识储备以及能力有限,本博客的观点和描述如有错漏或是有考虑不周到的地方还请多多包涵,欢迎互相探讨,一起学习,共同进步。

本文章可以转载,但是需要说明来源出处!

本文使用的部分图片来源于网上,若是侵权,请与本文作者联系删除: admin@icxzl.com