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

Node.js 环境安装与配置教程

Node.js 是基于 Chrome V8 引擎的 JavaScript 服务端运行环境,集成 npm 包管理工具。 Node.js 的安装流程,涵盖 Windows、macOS 及 Linux 系统的下载与安装步骤,重点讲解了环境变量配置、npm 国内镜像源切换方法以及常见问题的解决方案,帮助开发者快速搭建开发环境。

不知所云发布于 2026/3/28更新于 2026/10/19135 浏览
Node.js 环境安装与配置教程

Node.js 简介

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境,让 JavaScript 可以运行在服务器端。它包含 Node 核心程序和 npm(包管理工具),安装 Node.js 时会自动附带 npm,无需单独安装。

2025 年的 Node.js 已更新至 v24.x 版本,相比旧版本在性能、安全性和兼容性上有显著提升,推荐安装 LTS(长期支持版),适合生产环境使用。

下载 Node.js 安装包

访问官方下载地址

打开浏览器,进入 Node.js 官网:https://nodejs.org/

官网首页会自动识别你的操作系统(Windows/macOS/Linux),并推荐合适的版本(LTS 版为首选)。

选择对应版本下载

  • Windows 系统:根据系统位数选择(64 位系统选 node-v24.x.x-x64.msi,32 位选 x86,目前主流电脑均为 64 位)。
  • macOS 系统:推荐下载.pkg 安装包(图形化安装更简单),M1/M2 芯片选择 arm64 版本,Intel 芯片选择 x64。
  • Linux 系统:可通过源码编译或包管理器(如 apt/yum)安装,新手建议用.tar.xz 压缩包手动配置。

Windows 系统安装步骤

(1)找到下载的.msi 文件(如 node-v22.3.0-x64.msi),双击运行。

(2)直接点【Next】按钮,此处可根据个人需求修改安装路径,修改完毕后继续点击【Next】按钮。

(3)可根据自身需求进行,此处我选择默认安装,继续点击【Next】按钮。

(4)不选中,直接点击【Next】按钮。

(5)点击【Install】按钮进行安装。

(6)安装完毕,点击【Finish】按钮。

验证 Node.js 安装是否成功

打开命令行工具

  • Windows:按下 Win+R,输入 cmd 回车,打开「命令提示符」;或用 Win+X 选择「Windows PowerShell」。
  • macOS/Linux:打开「终端」(Terminal)。

执行验证命令

分别输入以下两条命令,若显示版本号则安装成功:

node -v # 查看 Node.js 版本
npm -v # 查看 npm 版本

环境变量配置(可选,推荐新手操作)

若安装时未勾选「Add to PATH」,或后续使用中出现 node 不是内部或外部命令 错误,需手动配置环境变量。

Windows 系统手动配置步骤:

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
  2. 在「系统变量」中找到 Path,点击「编辑」→「新建」,输入 Node.js 安装路径(如 D:\Program Files\nodejs)。
  3. 连续点击「确定」保存配置,重启命令行工具后生效。

npm 镜像源配置(解决下载慢问题)

npm 默认镜像源在国外,下载依赖包可能很慢,建议切换为国内镜像(如淘宝镜像)。

查看当前镜像源

npm config get registry

默认显示:https://registry.npmjs.org/

切换为淘宝镜像

npm config set registry https://registry.npmmirror.com/

(淘宝镜像 2024 年已更名为 npmmirror,旧地址 registry.npm.taobao.org 已停用)

验证镜像源是否切换成功

npm config get registry

显示 https://registry.npmmirror.com/ 即成功。

常见问题与解决方案

  1. 安装后命令行提示'node 不是内部或外部命令'
    • 原因:环境变量未配置或配置错误。
    • 解决:重新检查环境变量 Path 是否包含 Node.js 安装路径,重启命令行工具。
  2. npm 下载包时卡住或报错
    • 原因:网络问题或镜像源错误。
    • 解决:切换为国内镜像(见步骤七),或使用 cnpm(npm 的国内镜像客户端):
      npm install -g cnpm --registry=https://registry.npmmirror.com/
      
  3. Windows 安装时提示'权限不足'
    • 解决:右键安装包,选择「以管理员身份运行」。
  4. 卸载旧版本 Node.js
    • Windows:控制面板→程序和功能→卸载 Node.js;
    • macOS:终端执行 sudo rm -rf /usr/local/bin/node /usr/local/bin/npm(谨慎操作)。

总结

通过以上步骤,你已成功安装并配置了 Node.js 环境。后续开发中,可通过 npm install 包名 安装所需依赖,用 node 文件名.js 运行 JavaScript 文件。

目录

  1. Node.js 简介
  2. 下载 Node.js 安装包
  3. 访问官方下载地址
  4. 选择对应版本下载
  5. Windows 系统安装步骤
  6. 验证 Node.js 安装是否成功
  7. 打开命令行工具
  8. 执行验证命令
  9. 环境变量配置(可选,推荐新手操作)
  10. Windows 系统手动配置步骤:
  11. npm 镜像源配置(解决下载慢问题)
  12. 查看当前镜像源
  13. 切换为淘宝镜像
  14. 验证镜像源是否切换成功
  15. 常见问题与解决方案
  16. 总结

更多推荐文章

查看全部
  • C++ std::make_shared 详解
  • 深入理解 Linux 软链接与硬链接
  • Java 数据结构:从树形结构到二叉树详解
  • Java 高级工程师高频核心面试题
  • 从零开始掌握大模型:AI 新手全面学习指南
  • Visual C++ Redistributable 运行库安装与故障排查指南
  • AI 时代:赋能未来还是颠覆性科技革命?
  • Docker Compose restart 参数详解与生产实践
  • 使用基础模型自动化寻找人工生命 - MIT&OpenAI&Sakana AI
  • Visual Studio 2022 无法使用 GitHub Copilot 的排查与解决
  • 使用 DeepSeek 构建高性能贪吃蛇游戏实战
  • Linux 进程替换原理:从 fork 到 exec 详解
  • LLaMA-Factory 安装与配置教程
  • Web 安全实战:Shell 执行与成绩查询漏洞分析
  • Linux C++ 网络编程入门:TCP/UDP 模型与 Socket 基础
  • Windows 本地部署 Stable Diffusion 简易指南:ComfyUI 版
  • Django 请求对象 request 详解:前端传参与后端接收
  • RPCS3 开源模拟器:游戏兼容性与性能优化指南
  • SmolVLA 高算力适配:TensorRT 加速可行性分析与 ONNX 导出实操
  • C++26 核心功能详解:特性、语法与示例代码

相关免费在线工具

  • 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