nodejs指定版本安装的正确步骤及常见问题

 更新时间:2025年11月17日 08:48:09   作者:蓁蓁啊  
在当今的软件开发领域,Node.js已成为一种非常流行的开发工具,特别是对于需要处理大量并发请求的应用来说,Node.js的高效性能表现得尤为出色,这篇文章主要介绍了nodejs指定版本安装的正确步骤及常见问题,需要的朋友可以参考下

Node.js 安装指南(Ubuntu/Debian)

为什么不能用 sudo apt install nodejs?因为版本太老了!

问题诊断

错误方式

sudo apt install nodejs npm

问题:

  • Ubuntu 20.04 官方源:Node.js v10.x(2018年发布)
  • Ubuntu 22.04 官方源:Node.js v12.x(2019年发布)
  • Ubuntu 24.04 官方源:Node.js v18.x(勉强够用,但不是最新)

chrome-devtools-mcp 需要:Node.js ≥18

正确方式:使用 NodeSource 官方源

方法1:一键安装(推荐)

# 安装 Node.js 20.x(LTS 版本,推荐)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version  # 应该显示 v20.x.x
npm --version   # 应该显示 v10.x.x

方法2:使用国内镜像(网络不好时)

# 使用阿里云镜像
curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

升级已有的旧版本

步骤1:检查当前版本

node --version

如果显示 v10.xv12.xv14.xv16.x,需要升级。

步骤2:卸载旧版本

sudo apt remove nodejs npm
sudo apt autoremove

步骤3:安装新版本

# 使用 NodeSource 官方源
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version  # 应该显示 v20.x.x

版本选择

版本状态推荐场景安装命令
Node.js 20.xLTS(长期支持)✅ 生产环境、日常使用setup_20.x
Node.js 22.xCurrent(最新)尝鲜、测试新特性setup_22.x
Node.js 18.xLTS(维护中)兼容性要求高的项目setup_18.x

推荐:使用 Node.js 20.x(LTS)

常见问题

Q1: curl: command not found

sudo apt update
sudo apt install curl

Q2: 安装脚本下载失败

原因: 网络问题或 GFW

解决: 使用国内镜像

# 阿里云镜像
curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash -
sudo apt-get install -y nodejs

Q3: npm 权限错误

# 问题:npm install -g 提示权限错误
npm install -g some-package
# Error: EACCES: permission denied

# 解决方案1:配置 npm 全局目录(推荐)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 解决方案2:使用 sudo(不推荐)
sudo npm install -g some-package

Q4: 如何切换 Node.js 版本?

使用 nvm(Node Version Manager):

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

# 安装多个版本
nvm install 20
nvm install 18

# 切换版本
nvm use 20
nvm use 18

# 设置默认版本
nvm alias default 20

Q5: 卸载 Node.js

# 卸载通过 apt 安装的 Node.js
sudo apt remove nodejs npm
sudo apt autoremove

# 清理 NodeSource 源
sudo rm -f /etc/apt/sources.list.d/nodesource.list
sudo apt update

# 清理用户数据
rm -rf ~/.npm
rm -rf ~/.nvm

验证安装

完整检查清单

# 1. 检查 Node.js 版本
node --version
# 预期:v20.x.x 或更高

# 2. 检查 npm 版本
npm --version
# 预期:v10.x.x 或更高

# 3. 检查 npx
npx --version
# 预期:v10.x.x 或更高

# 4. 测试运行
node -e "console.log('Node.js 工作正常!')"
# 预期:输出 "Node.js 工作正常!"

# 5. 测试 npm
npm --version
# 预期:显示版本号

# 6. 测试全局安装(可选)
npm install -g cowsay
cowsay "安装成功!"
npm uninstall -g cowsay

为什么选择 NodeSource?

对比项Ubuntu 官方源NodeSource 官方源
更新速度❌ 慢(跟随 Ubuntu 发布周期)✅ 快(跟随 Node.js 发布)
版本❌ 老旧(v10-v18)✅ 最新(v18-v22)
安全更新✅ 有✅ 有
稳定性✅ 高✅ 高
官方支持❌ 社区维护✅ Node.js 官方认可

结论:NodeSource 是 Ubuntu/Debian 上安装 Node.js 的最佳方式。

快速命令参考

# 安装 Node.js 20.x(推荐)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs

# 国内镜像版本
curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash - && sudo apt-get install -y nodejs

# 升级已有版本
sudo apt remove nodejs npm && sudo apt autoremove && curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs

# 验证安装
node --version && npm --version

参考资源

  • NodeSource 官方仓库: https://github.com/nodesource/distributions
  • Node.js 官网: https://nodejs.org/
  • Node.js 发布计划: https://github.com/nodejs/release#release-schedule
  • 阿里云镜像: https://developer.aliyun.com/mirror/

“Don’t use the distro Node.js. It’s always outdated.”

— 每个遇到过版本问题的开发者

总结

到此这篇关于nodejs指定版本安装的正确步骤及常见问题的文章就介绍到这了,更多相关nodejs指定版本安装内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 详解node child_process模块学习笔记

    详解node child_process模块学习笔记

    这篇文章主要介绍了详解node child_process模块学习笔记,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • node.js中joi模块的基本使用方式

    node.js中joi模块的基本使用方式

    这篇文章主要介绍了node.js中joi模块的基本使用方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-09-09
  • npm的lock机制解析

    npm的lock机制解析

    这篇文章主要介绍了npm的lock机制解析,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-06-06
  • 修改NPM全局模式的默认安装路径的方法

    修改NPM全局模式的默认安装路径的方法

    这篇文章主要介绍了修改NPM全局模式的默认安装路径的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-12-12
  • node自定义安装更改npm全局模块默认安装路径的步骤

    node自定义安装更改npm全局模块默认安装路径的步骤

    有段时间没用npm了,新建个项目,需要改变npm全局包默认安装的路径,本文就来介绍一下node自定义安装更改npm全局模块默认安装路径的步骤,感兴趣的可以了解下
    2021-09-09
  • Node.js模块化的使用详细介绍

    Node.js模块化的使用详细介绍

    nodejs中的模块化是指将每个js文件会被认为单独一个的模块。模块之间是互相不可见的。如果一个模块需要使用另一个模块,那么需要通过指定语法来引入要使用的模块,而且只能使用引入模块所暴露的内容
    2022-08-08
  • Node.js 缓冲区(Buffer)模块的方法及实例分析

    Node.js 缓冲区(Buffer)模块的方法及实例分析

    在本篇文章里小编给大家整理了一篇关于Node.js 缓冲区(Buffer)模块的方法及实例分析,对此有兴趣的朋友们可以跟着学习下。
    2022-01-01
  • nodejs执行javaScript原理超详细讲解

    nodejs执行javaScript原理超详细讲解

    Node.js是目前非常流行的JavaScript运行环境,其背后有着强大的libuv库支撑其非阻塞I/O操作,这篇文章主要介绍了nodejs执行javaScript原理的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-11-11
  • Node.js本地文件操作之文件拷贝与目录遍历的方法

    Node.js本地文件操作之文件拷贝与目录遍历的方法

    这篇文章主要介绍了Node.js本地文件操作之文件拷贝与目录遍历的方法,拷贝用到了Node的文件API,遍历则举了一个异步API实现的形式(Node的一大特点),需要的朋友可以参考下
    2016-02-02
  • node.js利用mongoose获取mongodb数据的格式化问题详解

    node.js利用mongoose获取mongodb数据的格式化问题详解

    这篇文章主要给大家介绍了关于node.js利用mongoose获取mongodb数据的格式化问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习把。
    2017-10-10

最新评论