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

相关推荐
GDAL32 分钟前
Node.js v22.5+ 官方 SQLite 模块全解析:从入门到实战
数据库·sqlite·node.js
RunsenLIu4 小时前
基于Vue.js + Node.js + MySQL实现的图书销售管理系统
vue.js·mysql·node.js
Allen_zx7 小时前
Elpis - 基于 Koa + Vue3 的企业级全栈应用框架
node.js
小王子10247 小时前
Django+DRF 实战:从异常捕获到自定义错误信息
后端·django·web开发
鹏程7 小时前
局域网下五子棋,html+node.js实现
node.js·html
爱分享的程序员8 小时前
前端面试专栏-算法篇:17. 排序算法
前端·javascript·node.js
盛夏绽放8 小时前
接口验证机制在Token认证中的关键作用与优化实践
前端·node.js·有问必答
GDAL10 小时前
Node.js REPL 教程
node.js·编辑器·vim
whale fall11 小时前
npm install安装不成功(node:32388)怎么解决?
前端·npm·node.js
晴风向上11 小时前
mac mini m4安装node.js@16以下版本方法
macos·node.js