在 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 开发环境!

相关推荐
咖啡教室1 分钟前
nodejs开发后端服务详细学习笔记
后端·node.js
不爱吃鱼的猫-1 小时前
Node.js 安装与配置全攻略:从入门到高效开发
服务器·node.js
你的人类朋友2 小时前
JS严格模式,启动!
javascript·后端·node.js
前端啊龙2 小时前
为什么需要 Node.js 的 URL 处理工具?
node.js
veminhe5 小时前
NodeJS--NPM介绍使用
node.js
还是鼠鼠15 小时前
Node.js全局生效的中间件
javascript·vscode·中间件·node.js·json·express
Summer_Xu19 小时前
模拟 Koa 中间件机制与洋葱模型
前端·设计模式·node.js
Misnearch1 天前
node.js版本管理
node.js
转转技术团队1 天前
代码变更暗藏危机?代码影响范围分析为你保驾护航
前端·javascript·node.js