最新版Node.js下载安装及环境配置教程一、 版本选型说明二、 安装准备三、 Windows系统安装步骤3.1 下载安装包3.2 安装3.3 环境变量验证自动配置无需手动操作四、 环境配置扩展五、总结一、 版本选型说明Node.js作为前端开发、自动化工具如Appium的核心依赖版本选择直接影响环境稳定性和安全性。Node.js v20.x系列于2023年10月发布目前为长期支持LTS版本官方维护周期至2026年4月提供持续的安全更新、Bug修复和生态适配支持是生产环境与测试环境的首选版本。提示暂不推荐v18.x等非LTS版本维护周期短和v21.x开发版稳定性不足v20.x LTS是兼顾稳定性、安全性和适配性的最优解尤其适合Appium自动化测试环境。二、 安装准备2.1 系统要求Windows系统Windows 10及以上64位避免32位系统部分依赖包不兼容。2.2 前置注意事项安装路径禁止包含中文、空格及特殊字符建议自定义路径如WindowsD:\Develop\NodejsmacOS/usr/local/nodejs避免后续工具调用报错。若已安装旧版Node.js如v16.x需先卸载干净控制面板/终端卸载删除残留文件夹和环境变量再安装v20.x LTS避免版本冲突。确保网络通畅安装过程需下载安装包及依赖建议提前配置镜像源下文会提及。三、 Windows系统安装步骤3.1 下载安装包推荐v20.11.0及以上版本适配性最优我选择的是v20.20.0版本Node.js-v20.20.0安装包https://pan.xunlei.com/s/VOtmRHYtSuoI0I-QK8VZ6Vc6A1?pwd56g2#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中无需手动配置验证步骤如下按下WinR键输入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_cache4.4 验证配置执行 npm config get prefix 和 npm config get cache输出对应自定义路径即配置成功。npm config get prefixnpm config get cache4.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_global4生效配置依次点击所有窗口的【确定】重启cmd命令窗口环境变量需重启终端生效。4.6 测试配置有效性安装express验证通过全局安装express模块验证路径和环境变量是否配置成功1以管理员身份 重启cmd命令窗口使环境变量生效执行全局安装命令npm install express -g-g参数表示全局安装2 结果验证✅ 成功标识命令执行无报错打开node_global文件夹会自动生成node_modules文件夹express模块存于该目录下后续全局安装的包如Appium会自动存入node_global且可直接通过命令调用。4.7 常见问题解决1执行npm安装命令npm install -g appium时出现了 EPERM 权限错误核心是文件访问权限不足或相关目录 / 文件被占用导致 npm 无法写入缓存文件和日志文件。2解决方案修改 Node.js 缓存目录node_cache的权限1、打开文件资源管理器定位到 D:\Myworksoftware\Node.js2、找到 node_cache 文件夹右键点击它选择「属性」3、切换到「安全」选项卡在「组或用户名」中找到你当前的用户shugh4、点击下方的「编辑」在弹出的窗口中选中你的用户然后在「权限」列表中勾选「完全控制」允许列下的所有选项点击「应用」→「确定」关闭所有属性窗口5、重新执行安装命令 npm install -g appium。五、总结Node.js v20.x LTS版本作为当前长期支持版本是搭建AppiumPythonJenkins自动化测试环境的理想依赖。安装完成后可无缝对接后续Appium、Python客户端及Jenkins的配置为自动化测试流程奠定坚实基础。若需适配其他工具可基于此版本灵活扩展无需担心版本兼容问题。