在 Windows上安装 Node.js 开发环境的完整指南

在 Windows上安装 Node.js 开发环境的完整指南


一、安装 Node.js 和 npm

  1. 下载 Node.js 安装包
  • 访问官网 Node.js --- 在任何地方运行 JavaScript
  • 下载 LTS 版本(长期支持版,推荐)或最新版(Current)。
  1. 运行安装程序
  • 双击下载的 .msi 文件启动安装向导。

关键配置选项

  • ✅ 勾选 **Add to PATH**(自动添加环境变量)
  • ✅ 选择 **Install additional tools**(可选,自动安装 Chocolatey、Python 等工具,适合新手)
  • 默认安装路径为 C:\Program Files\nodejs\(建议保持默认)。
  1. 完成安装
  • 点击 "Next" 直到安装完成。
  1. 验证安装
  • 打开 CMD 或 PowerShell,输入以下命令:

    node -v # 查看 Node.js 版本(如 v20.12.2)
    npm -v # 查看 npm 版本(如 10.5.0)


二、配置开发环境

1. 解决权限问题(可选)

  • 修改 npm 全局模块安装路径,避免管理员权限问题:

    创建全局模块存放目录(例如 D:\node_global)

    mkdir D:\node_global
    mkdir D:\node_cache

    配置 npm

    npm config set prefix "D:\node_global"
    npm config set cache "D:\node_cache"

    将路径添加到系统环境变量 PATH 中(控制面板 → 系统 → 高级系统设置 → 环境变量)

2. 安装包管理工具 Yarn(可选)

复制代码
npm install -g yarn
yarn --version

3. 使用 nvm 管理多版本 Node.js(可选)


三、安装开发工具

  1. 代码编辑器
  • VS Code(推荐):
  • 安装插件:ESLint、Prettier、Code Runner、Node.js Extension Pack
  1. 版本控制
  • 安装 Git for Windows:

    git --version # 验证安装

  1. API 测试工具
  • Postman 或 Insomnia

四、创建并运行第一个 Node.js 项目

  1. 初始化项目

    mkdir my-project
    cd my-project
    npm init -y # 生成 package.json

  2. 创建示例文件

  • 新建 app.js,写入代码:

    console.log("Hello, Node.js!");

  1. 运行脚本

    node app.js # 输出 "Hello, Node.js!"


五、常见问题解决

  1. 命令提示符报错 'node' is not recognized
  • 原因:环境变量未生效。
  • 解决:重启终端或手动添加 C:\Program Files\nodejs\ 到系统 PATH。
  1. npm 安装包失败(权限不足)
  • 以管理员身份运行终端,或按 第二部分第1步 配置自定义全局路径。
  1. 版本冲突
  • 使用 nvm 管理多版本 Node.js。

六、扩展:启用 WSL(可选)

  1. 安装 WSL

    wsl --install # 自动安装 WSL 和默认 Linux 发行版(如 Ubuntu)

  2. 在 WSL 中安装 Node.js

    sudo apt update && sudo apt upgrade
    curl -fsSL https://deb.nodesource.com/setup_lts.x |
    sudo -E bash - sudo apt install -y nodejs


通过以上步骤,你已成功在 Windows 11 上搭建了完整的 Node.js 开发环境!

相关推荐
天天扭码18 分钟前
什么?2025年了还在写传统爬虫!来试试更有爽感的AI爬虫 ψ(`∇´)ψ
爬虫·node.js·ai编程
小玖儿1 小时前
macOS 使用 NVM 升级 Node.js 完整操作
node.js
傻小胖10 小时前
Node.js 模块导入的基本流程
node.js
魔云连洲11 小时前
详解Node.js中的setImmediate()函数
node.js
梦想平凡17 小时前
三网通电玩城平台系统结构与源码工程详解(二):Node.js 服务端核心逻辑实现
node.js
傻小胖18 小时前
发布一个npm包,更新包,删除包
前端·npm·node.js
叱咤少帅(少帅)20 小时前
Node.js 开发项目
node.js
DN金猿1 天前
使用npm install或cnpm install报错解决
前端·npm·node.js
layman05281 天前
node.js 实战——(Http 知识点学习)
http·node.js
2501_915373881 天前
Node.js 学习入门指南
学习·node.js