【保姆级教程】最新Node安装教程，手把手安装Node.js！从下载到跑通第一个脚本，环境变量？版本切换？一次搞定全避坑！

【保姆级教程】最新Node安装教程，手把手安装Node.js！从下载到跑通第一个脚本，环境变量？版本切换？一次搞定全避坑！🚀

温馨提示： 本教程基于 Windows 系统 + Node.js LTS（长期支持版）。虚拟机环境同样适用！保姆级细节覆盖所有高频坑点，跟着做绝不翻车！

0. 唠嗑在前：Node.js 是啥？

想象一下，你熟悉的JavaScript语言突然“变异”了：

• 🌍 突破浏览器限制： 能在你的电脑上直接运行JS代码！
• 🛠 自带工具箱 (npm)： 百万级代码库随用随取（比如React/Vue全家桶）。
• 💻 后端开发入门砖： 能写服务器、操作数据库、建API接口！
  装好它，你就解锁了 “全栈开发” 的成就！

1. 认准官网，下载正版安装包

第1步：直捣黄龙，官网下载

• 打开浏览器，访问 Node.js 下载页。
• 推荐 LTS版（长期支持版），稳如老狗！直接点击大大的 绿色下载按钮！
  

💡 保姆小课堂：

• LTS版 (推荐)： 稳定可靠，企业首选，版本号偶数（如18.x, 20.x）
• Current版 (尝鲜)： 包含最新功能，但可能有小bug，版本号奇数（如21.x）
  新手无脑选LTS！

第2步：坐等下载完成

• 文件名类似 node-v20.x.x-x64.msi（64位系统）。
• 记住文件保存位置（通常是 下载 文件夹）。

---

2. 安装进行时：手把手点点点

第3步：双击开装！

• 找到下载好的 .msi 文件，双击运行。若出现用户账户控制提示？点 是！

第4步：霸王条款？我同意！

• 安装向导启动，点击 Next。
  

• 勾选 I accept the terms... （我接受协议），点 Next。
  

第5步：惊天巨坑预警！⚠️ 安装路径

• 默认路径：C:\Program Files\nodejs\

  • 坑点1：带空格！ 某些老旧工具可能抽风！
  • 坑点2：路径深！ 看着就头晕！

• 最优解：点 Change... 修改路径！

  • 推荐：D:\nodejs\ （根目录，超简洁！）
  • 原则：无中文！无空格！路径短！
    

• 改好路径后，点 Next。

第6步：核心功能勾选 - 必看！（如果你选择的是和我一样的版本，之后可以跳过第7、8步）

• 如果你是下载的和熊猫一样的版本，直接点击 Next 即可。
  
• 此处不勾选，直接点击 Next 即可。
  
• 点 Install 开始安装！
  

第7步：核心功能勾选 - 必看！（非本版本参考提醒）

• ✅ 务必勾选 Automatically install the necessary tools...
  • 作用： 自动安装编译工具（Python/C++库），未来装某些npm包不报错！
  • 代价： 会额外下载约200MB，但值得！
• 其他选项默认即可，点 Next >。

第8步：环境变量自动配置 - 新手福音！（非本版本参考提醒）

• ✅ 务必勾选 Add to PATH！

  • 作用： 让系统在任何位置都能识别 node 和 npm 命令！
  • 不勾选的后果： 命令行输入 node -v 提示“不是内部命令”！

• 点 Install 开始安装！

第9步：喝杯咖啡，等待完成

• 进度条跑完，点 Finish。
  

---

3. 验明正身！验证安装 + 跑通第一个脚本

第10步：基础验证 - 必做！

1. Win + R 输入 cmd 打开命令提示符。
   

2. 输入第一条咒语：

   node -v
   

   • 成功标志： 显示版本号（如 v20.13.1）。
     

3. 输入第二条咒语：

   npm -v
   

   • 成功标志： 显示版本号（如 10.5.0）。
     

💡 恭喜！ 看到版本号，说明Node.js和它的包管家npm已成功入驻！

第11步：跑个Hello World脚本！（这个不重要，可以跳过啦）

1. 桌面右键 -> 新建文本文档 -> 重命名为 hello.js （注意后缀是 .js 不是 .txt！）。
2. 右键用记事本打开，输入代码：

   // 这就是Node.js代码！
   console.log("Hello, Node保姆！我是你的第一个脚本！");
   

3. 保存文件。
4. 在 hello.js 所在文件夹，按住 Shift + 右键 -> “在此处打开命令窗口” 或 “打开Powershell窗口”。
5. 输入执行命令：

   node hello.js
   

6. 见证奇迹： 终端打印出 Hello, Node保姆！我是你的第一个脚本！ 🎉

---

4. 高级生存技能：版本切换 + 镜像加速

第12步：解决npm安装慢问题（国内必看）

• 问题： 默认npm仓库在国外，下载包像蜗牛爬！
• 解决方案：切换国内镜像源！
  在命令行执行：

  npm config set registry https://registry.npmmirror.com
  

  • 验证是否生效：

    npm config get registry
    

    显示 https://registry.npmmirror.com 就对了！
    

第13步：安装nvm（多版本切换神器）(选做)

• 为什么需要？ 不同项目可能需要不同Node版本（如老项目用v14，新项目用v20）。
• 保姆级安装：

  1. 访问 nvm-windows 官网。

  2. 下载最新版 nvm-setup.exe （如 nvm-setup-v1.2.2.exe）会有点慢静静等待。
     

  3. 双击安装，同意用户协议，路径推荐 D:\nvm。
     

  4. 关键一步： 安装程序会询问 “Node.js 安装路径”，填 D:\nvm\nodejs （和nvm同目录）。
     
     默认直接点击 Next
     
     

  5. 安装完成后，重启命令行。

• 保姆级使用：

  nvm list available    # 查看可安装版本
  nvm install 18.20.1   # 安装指定版本
  nvm install 20.13.1   # 安装另一版本
  nvm use 20.13.1       # 切换到v20
  nvm list              # 查看已安装版本
  

---

5. 常见翻车现场 & 保姆急救包

🚑 Q1：安装后输入 node -v 提示“不是内部命令”

• A1：
  • 安装时 没勾选 Add to PATH！ （回看步骤8）
  • 手动补救：
    1. Win + R 输入 sysdm.cpl -> 高级 -> 环境变量。
    2. 在 系统变量 中找到 Path -> 编辑。
    3. 添加两行（根据你的安装路径）：

       D:\nodejs\
       D:\nodejs\node_modules\npm\bin
       

    4. 层层点确定保存！ 重启命令行。

🐢 Q2：npm install 卡住或巨慢

• A2：
  • 未切换国内镜像源！ （回看步骤12）
  • 临时用淘宝镜像安装：

    npm install 包名 --registry=https://registry.npmmirror.com
    

🔄 Q3：nvm 安装后无法切换版本

• A3：
  • 检查安装路径是否包含空格/中文？重装到 D:\nvm。
  • 以 管理员身份 运行命令行使用nvm。
  • 确保之前安装的Node.js已卸载（控制面板删除）。

🚫 Q4：运行脚本报错 “无法加载文件… 因为在此系统上禁止运行脚本”

• A4（PowerShell权限问题）：
  1. 以 管理员身份 打开 PowerShell。
  2. 输入：

     Set-ExecutionPolicy RemoteSigned
     

  3. 输入 Y 确认。

---

6. 结尾 & 保姆的叮嘱

恭喜！🎉 你已成功召唤 Node.js 引擎和它的百万级武器库 (npm)！接下来可以：

• 用 npm install -g yarn 安装更快的包管理器
• 学习搭建 Vue/React 项目（一句命令搞定！）
• 尝试写个简单的HTTP服务器（开启后端之路）

灵魂拷问区：

• 你卡在了哪一步？ 评论区喊救命，保姆秒回！
• 下篇想看什么？ Vue脚手架搭建？Express写接口？留言点菜！

下期预告：
还没想好(。>︿<)_θ，有啥想知道的大家可以打在评论区

---

保姆的终极安全提示：
✅ 虚拟机玩家： 装完Node.js后 立即拍快照 (Node_20_Installed)
✅ 版本管理： 正式项目用 nvm 或 .nvmrc 锁定Node版本
✅ 镜像加速： 国内开发必设 npmmirror.com 镜像源

Now, Let’s Code! 😄