Node.js 版本选择、下载安装及环境配置教程

提示：若出现「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:\Develop\Nodejs\node_global"
# 配置缓存路径
npm config set cache "D:\Develop\Nodejs\node_cache"

4.4 验证配置

执行 npm config get prefix 和 npm config get cache，输出对应自定义路径即配置成功。

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

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

1. 打开环境变量窗口：右键【此电脑】→【属性】→【高级系统设置】→【环境变量】；在【系统变量】区域点击【新建】，输入以下内容：
   • 变量名：NODE_PATH
   • 变量值：D:\Develop\Nodejs\node_global\node_modules（后续安装全局包后，会自动生成 node_modules 文件夹）
2. 在【系统变量】区域找到【Path】，点击【编辑】→【新建】；输入 %NODE_PATH%，点击【确定】保存。
3. 修改用户变量（Path 路径）：
   • 在【用户变量】区域找到【Path】，点击【编辑】；
   • 删除默认的 C 盘路径（通常为 C:\Users\用户名\AppData\Roaming\npm）；
   • 点击【新建】，添加自定义的 node_global 路径（例：D:\Develop\Nodejs\node_global）。
4. 生效配置：依次点击所有窗口的【确定】，重启 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）的权限：
   • 打开文件资源管理器，定位到 D:\Develop\Nodejs；
   • 找到 node_cache 文件夹，右键点击它，选择「属性」；
   • 切换到「安全」选项卡，在「组或用户名」中找到你当前的用户；
   • 点击下方的「编辑」，在弹出的窗口中，选中你的用户，然后在「权限」列表中勾选「完全控制」（允许列下的所有选项）；点击「应用」→「确定」，关闭所有属性窗口；
   • 重新执行安装命令 npm install -g appium。

五、总结

Node.js v20.x LTS 版本作为当前长期支持版本，是搭建 Appium+Python+Jenkins 自动化测试环境的理想依赖。

安装完成后，可无缝对接后续 Appium、Python 客户端及 Jenkins 的配置，为自动化测试流程奠定坚实基础。若需适配其他工具，可基于此版本灵活扩展，无需担心版本兼容问题。