欢迎光临
我们一直在努力

Ubuntu 系统(包括 WSL 中的 Ubuntu)安装 Node.js、npm 和 Yarn

以下是在 Ubuntu 系统(包括 WSL 中的 Ubuntu)安装 Node.js、npm 和 Yarn 的完整步骤,涵盖多种安装方式及常见问题解决方案:


一、安装 Node.js 和 npm

方法 1:通过 NodeSource 安装(推荐,版本新)
  • 添加 NodeSource 仓库(以 Node.js 20.x 为例):

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

    • 如果需要其他版本(如 18.x),替换链接中的 20.x。
  • 安装 Node.js 和 npm:

    sudo apt install -y nodejs

  • 验证安装:

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


  • 方法 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

  • 验证安装:

    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 的输出结果。
  • 赞(0)
    未经允许不得转载:171主机测评 » Ubuntu 系统(包括 WSL 中的 Ubuntu)安装 Node.js、npm 和 Yarn
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址