跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.js大前端

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

在 Windows 系统上安装 Node.js 的详细步骤,包括下载官方安装包、配置全局模块路径(node_global)和缓存路径(node_cache)、设置环境变量 NODE_PATH 及 Path。此外,还演示了如何配置淘宝镜像源以加速 npm 包下载,并通过安装 express 模块验证环境是否配置成功。针对常见权限错误提供了删除 .npmrc 文件或修改文件夹权限的解决方案。

ServerBase发布于 2026/3/30更新于 2026/10/1594 浏览

一、进入官网地址下载安装包

访问 Node.js 中文网,选择对应系统的版本(如 Windows 64 位)。

二、安装程序

  1. 双击安装包开始安装。
  2. 点击 Next,可根据需求修改安装路径,继续点击 Next。
  3. 选择默认安装选项,继续点击 Next。
  4. 取消选中额外组件选项,直接点击 Next。
  5. 点击 Install 进行安装。
  6. 安装完毕后点击 Finish。
  7. 测试安装是否成功:按下 Win+R 键,输入 cmd 打开命令提示符窗口。 输入 node -v 显示 Node.js 版本。 输入 npm -v 显示 npm 版本。 若显示版本号,说明安装成功。

三、环境配置

1. 创建目录

找到安装目录,新建两个文件夹:node_global 和 node_cache。

2. 配置 npm 路径

使用管理员身份打开 cmd 命令窗口,输入以下命令(请替换为实际路径):

npm config set prefix "D:\common\develop\Nodejs\node_global"
npm config set cache "D:\common\develop\Nodejs\node_cache"

输入以下命令查看路径是否配置正确:

npm config get prefix
npm config get cache

3. 配置环境变量

  1. 右键'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'。
  2. 在'系统变量'中点击'新建'。 变量名:NODE_PATH 变量值:D:\common\develop\Nodejs\node_global\node_modules
  3. 编辑'用户变量'中的 Path。
  4. 将默认的 AppData\Roaming\npm 修改为 node_global 的路径。
  5. 在'系统变量'中选择 Path 点击'编辑',新建 %NODE_PATH%,点击确定保存。

四、测试

配置完成后,全局安装一个最常用的 express 模块进行测试(需使用管理员方式打开 cmd):

npm install express -g

出现安装界面即为配置成功。

常见问题解决

如果未使用管理员方式打开 cmd 可能会报错。 解决方法 1: 在 C:\Users\{用户名} 下找到 .npmrc 文件并删除(注意不是安装目录下的)。重新输入 npm install express -g。 解决方法 2: 找到安装目录下的 node_global 和 node_cache 文件夹,右键 node_global -> '属性' -> '安全' -> '编辑',勾选所有权限,点击确定。node_cache 步骤同理。

五、安装淘宝镜像

淘宝镜像提供国内更快的下载速度。

  1. 安装淘宝镜像:
    npm config set registry https://registry.npmmirror.com
    
    查看是否成功:
    npm config get registry
    
  2. 安装 cnpm(按需安装):
    npm install -g cnpm --registry=https://registry.npmmirror.com
    
    查看是否安装成功:
    cnpm -v
    

若提示 'cnpm' 不是内部或外部命令,检查 npm config ls 确认 prefix 和 cache 路径是否正确。若配置有误,先卸载再重新安装:

npm uninstall cnpm -g
npm install -g cnpm --registry=https://registry.npmmirror.com

六、配置检查

若遇到问题,可检查以下内容:

  1. 打开 cmd 敲命令检查环境。
  2. 打开环境变量配置检查用户变量和系统变量。
  3. 打开安装目录检查是否有 node_global 和 node_modules 文件夹。

目录

  1. 一、进入官网地址下载安装包
  2. 二、安装程序
  3. 三、环境配置
  4. 1. 创建目录
  5. 2. 配置 npm 路径
  6. 3. 配置环境变量
  7. 四、测试
  8. 常见问题解决
  9. 五、安装淘宝镜像
  10. 六、配置检查

更多推荐文章

查看全部
  • Mac 系统部署 OpenClaw 本地 AI 自动化框架指南
  • 宇树机器人 G1 导航仿真:地图转换与参数配置
  • VS Code 远程 SSH 环境下 Copilot 无法使用 Claude 模型
  • GitHub Copilot 接入第三方模型 API 配置教程
  • Flutter mediapipe_core 鸿蒙化适配指南:端侧 AI 推理与手势识别
  • Unreal Engine 4.27 搭建 AirSim 无人机仿真环境:澳大利亚农村场景
  • AMD 显卡 llama.cpp 兼容性与部署指南
  • 在 Windows 上通过 VMware 安装 Linux
  • 基于采样的 MPC 控制 MPPI 算法及 ROS C++ Python 仿真
  • 扩散模型(Diffusion Model)原理与图像生成实战
  • Git 核心原理与基础使用详解(上)
  • C++ 多态详解:概念、实现与底层原理
  • Java 环境配置与首个程序实战:JDK + IDEA 从零搭建
  • Pandas 绘图模块常用方法精讲:lag_plot、parallel_coordinates 等
  • Clawdbot(Moltbot) 飞书机器人配置教程
  • 使用 Higress 将 REST API 转换为 MCP Server 工具
  • OpenClaw 对接飞书实现多个机器人自动群聊配置
  • 微信小程序自定义 tabBar 实现方案
  • VLA机器人革命:解析当下10篇最关键的视觉-语言-动作模型论文
  • 在浏览器中运行 Python:Pyodide 实战指南

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online