在 Windows上安装 Node.js 开发环境的完整指南
在 Windows上安装 Node.js 开发环境的完整指南
一、安装 Node.js 和 npm
- 下载 Node.js 安装包
- 访问官网 Node.js — 在任何地方运行 JavaScript
- 下载 LTS 版本（长期支持版，推荐）或最新版（Current）。
- 运行安装程序
- 双击下载的 .msi 文件启动安装向导。
关键配置选项：
- 勾选 **Add to PATH**（自动添加环境变量）
- 选择 **Install additional tools**（可选，自动安装 Chocolatey、Python 等工具，适合新手）
- 默认安装路径为 C:\Program Files\nodejs\（建议保持默认）。
- 完成安装
- 点击 “Next” 直到安装完成。
- 验证安装
- 打开 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 --version3. 使用 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 # 切换版本三、安装开发工具
- 代码编辑器
- VS Code（推荐）：
- 安装插件：ESLint、Prettier、Code Runner、Node.js Extension Pack。
- 版本控制
- 安装 Git for Windows：
git --version # 验证安装- API 测试工具
- Postman 或 Insomnia
四、创建并运行第一个 Node.js 项目
- 初始化项目
mkdir my-project
cd my-project
npm init -y # 生成 package.json- 创建示例文件
- 新建 app.js，写入代码：
console.log("Hello, Node.js!");- 运行脚本
node app.js # 输出 "Hello, Node.js!"五、常见问题解决
- 命令提示符报错 'node' is not recognized
- 原因：环境变量未生效。
- 解决：重启终端或手动添加 C:\Program Files\nodejs\ 到系统 PATH。
- npm 安装包失败（权限不足）
- 以管理员身份运行终端，或按 第二部分第1步 配置自定义全局路径。
- 版本冲突
- 使用 nvm 管理多版本 Node.js。
六、扩展：启用 WSL（可选）
- 安装 WSL
wsl --install # 自动安装 WSL 和默认 Linux 发行版（如 Ubuntu）- 在 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 开发环境！