云计算百科
云计算领域专业知识百科平台

2026最新版Node.js下载安装 版本选择 及 环境配置教程(详细图文附安装包)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后,紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

目录

  • 最新版Node.js下载安装及环境配置教程
    • 一、 版本选型说明
    • 二、 安装准备
    • 三、 Windows系统安装步骤
      • 3.1 下载安装包
      • 3.2 安装
      • 3.3 环境变量验证(自动配置,无需手动操作)
    • 四、 环境配置(扩展)

最新版Node.js下载安装及环境配置教程

一、 版本选型说明

Node.js作为前端开发、自动化工具(如Appium)的核心依赖,版本选择直接影响环境稳定性和安全性。Node.js v20.x系列于2023年10月发布,目前为长期支持(LTS)版本,官方维护周期至2026年4月,提供持续的安全更新、Bug修复和生态适配支持,是生产环境与测试环境的首选版本。

相较于已停止维护的v16.x版本(2023年9月终止支持),v20.x LTS具备以下优势:

  • 兼容性更强:完美适配Appium 2.x+、JDK 17.0.10、Python 3.11.9等主流自动化技术栈,无驱动加载失败、服务启动异常等兼容问题。

  • 安全性升级:修复了v16.x系列遗留的安全漏洞,支持TLS 1.3增强加密,适合企业级自动化测试环境部署。

  • 性能优化:提升了异步I/O处理效率,启动Appium Server速度更快,脚本执行时资源占用更低。

  • 生态完善:npm包管理工具随版本同步升级,支持更多新特性,适配各类自动化依赖包的安装需求。

  • 提示:暂不推荐v18.x(等非LTS版本,维护周期短)和v21.x+(开发版,稳定性不足),v20.x LTS是兼顾稳定性、安全性和适配性的最优解,尤其适合Appium自动化测试环境。

    二、 安装准备

    2.1 系统要求

    • Windows系统:Windows 10及以上(64位),避免32位系统(部分依赖包不兼容)。

    2.2 前置注意事项

  • 安装路径禁止包含中文、空格及特殊字符,建议自定义路径(如Windows:D:\\Develop\\Nodejs,macOS:/usr/local/nodejs),避免后续工具调用报错。

  • 若已安装旧版Node.js(如v16.x),需先卸载干净(控制面板/终端卸载,删除残留文件夹和环境变量),再安装v20.x LTS,避免版本冲突。

  • 确保网络通畅,安装过程需下载安装包及依赖,建议提前配置镜像源(下文会提及)。

  • 三、 Windows系统安装步骤

    3.1 下载安装包

    • 获取需要的资源 Node.js下:
    • https://gitcode.com/resource-lib/resouece/blob/main/README.md

    3.2 安装

    (1)双击下载的.msi安装包,弹出安装向导,点击「下一步」

    在这里插入图片描述 (2) 勾选「我接受许可协议中的条款」,点击「下一步」 在这里插入图片描述

    (3) 自定义安装路径(例:D:\\Develop\\Nodejs),点击「下一步」 在这里插入图片描述

    (4)组件选择默认全选(包括Node.js runtime、npm package manager、Online documentation shortcuts等),点击「下一步」 在这里插入图片描述

    (5) 高级选项保持默认(无需勾选「自动安装必要的工具」,避免额外安装Visual Studio组件),点击「下一步」 在这里插入图片描述

    (6)点击「安装」,等待安装完成(耗时1-3分钟,取决于网络速度),完成后点击「完成」

    在这里插入图片描述 在这里插入图片描述

    3.3 环境变量验证(自动配置,无需手动操作)

    Node.js v20.x安装程序会自动将安装路径和npm路径添加到系统环境变量Path中,无需手动配置,验证步骤如下:

  • 按下Win+R键,输入cmd打开命令提示符。

  • 输入命令node -v,若输出v20.x.x(如v20.11.0),说明Node.js安装成功。

  • 输入命令npm -v,若输出对应版本号(如10.2.4),说明npm包管理工具同步安装成功。 在这里插入图片描述

  • 提示:若出现「node不是内部或外部命令」,需重启电脑使环境变量生效,或手动检查Path变量是否包含Node.js安装路径(如D:\\Develop\\Nodejs)和npm路径(如D:\\Develop\\Nodejs\\node_modules\\npm\\bin)

    四、 环境配置(扩展)

    • 默认情况下,npm全局包会存于C:\\Users\\用户名\\AppData\\Roaming\\npm,缓存文件存于同目录下的npm-cache文件夹,不仅会持续占用C盘系统空间,还可能因系统目录权限管控严格,导致全局包安装失败。创建node_global和node_cache文件夹,核心是自定义npm全局包的安装路径和缓存路径,将资源转移到非系统盘(如D盘),既能规避上述问题,又便于集中管理全局包,后续迁移、卸载工具更便捷。 需要说明的是,这部分配置并非强制要求,若仅用于临时测试、安装少量全局包,不配置也可正常使用,但需始终以管理员身份运行cmd安装全局包。

    4.1 找到安装的目录,在安装目录下新建两个文件夹【node_global】和【node_cache】

    在这里插入图片描述

    4.2 以管理员身份打开 cmd: 点击左下角【开始】菜单,搜索“命令提示符”,右键选择【以管理员身份运行】 必须管理员权限,否则可能出现权限不足报错 在这里插入图片描述

    4.3 以管理员身份打开 cmd,执行以下命令(替换为自己的文件夹路径): 注意区分prefix(全局包路径)和cache(缓存路径)

    # 配置全局包路径
    npm config set prefix "D:\\Myworksoftware\\Node.js\\node_global"
    # 配置缓存路径
    npm config set cache "D:\\Myworksoftware\\Node.js\\node_cache"

    4.4 验证配置:执行 npm config get prefix 和 npm config get cache,输出对应自定义路径即配置成功。 npm config get prefix npm config get cache 在这里插入图片描述

    4.5 配置系统/用户环境变量

    环境变量配置是关键,需同时调整用户变量和系统变量,确保全局命令可正常调用

    (1)打开环境变量窗口:右键【此电脑】→【属性】→【高级系统设置】→【环境变量】;在【系统变量】区域点击【新建】,输入以下内容:

    变量名:NODE_PATH

    变量值:D:\\Myworksoftware\\Node.js\\node_global\\node_modules(后续安装全局包后,会自动生成node_modules文件夹) 在这里插入图片描述

    (2)在【系统变量】区域找到【Path】,点击【编辑】→【新建】;

    输入 %NODE_PATH%,点击【确定】保存;

    (3) 修改用户变量(Path路径):

    在【用户变量】区域找到【Path】,点击【编辑】;

    删除默认的C盘路径(通常为C:\\Users\\用户名\\AppData\\Roaming\\npm);

    点击【新建】,添加自定义的node_global路径(例:D:\\Myworksoftware\\Node.js\\node_global);

    在这里插入图片描述 在这里插入图片描述

    在这里插入图片描述

    (4)生效配置:依次点击所有窗口的【确定】,重启cmd命令窗口(环境变量需重启终端生效)。

    4.6 测试配置有效性(安装express验证)

    通过全局安装express模块,验证路径和环境变量是否配置成功

    (1)以管理员身份 重启cmd命令窗口(使环境变量生效),执行全局安装命令:

    npm install express -g (-g参数表示全局安装)

    (2) 结果验证:

    ✅ 成功标识:命令执行无报错,打开node_global文件夹,会自动生成node_modules文件夹,express模块存于该目录下; 后续全局安装的包(如Appium)会自动存入node_global,且可直接通过命令调用。 在这里插入图片描述

    赞(0)
    未经允许不得转载:网硕互联帮助中心 » 2026最新版Node.js下载安装 版本选择 及 环境配置教程(详细图文附安装包)
    分享到: 更多 (0)

    评论 抢沙发

    评论前必须登录!