在 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（可选）

• 安装 nvm-windows（Windows 版 Node 版本管理器）。https://github.com/coreybutler/nvm-windows/releases

• 常用命令：

  nvm list available # 查看可安装版本
  nvm install 18.16.0 # 安装指定版本
  nvm use 18.16.0 # 切换版本

---

三、安装开发工具

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