在 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

1. 创建示例文件

• 新建 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）

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