nodejs教程零基础环境搭建详细步骤

刚接触 Node.js 的新手小白，是不是一听到 “环境搭建” 就头大？下载安装包后不知道点哪里，安装完输命令没反应，好不容易弄好又报各种错，折腾半天连 “Hello World” 都跑不起来？别担心，今天兔子哥就带大家一步一步搞定 Node.js 环境搭建，从下载到验证，每个步骤都讲得明明白白，哪怕你是电脑小白，跟着做也能一次成功，一起往下看吧！

一、准备工作：选对版本，少走弯路

在开始安装前，得先搞懂该下哪个版本，不然装完可能出现各种兼容问题。Node.js 官网有两个版本：

• LTS 版本：长期支持版，比如 v20.x.x，稳定性高，bug 少，适合新手和生产环境；
• Current 版本：最新版，有新功能但可能不稳定，适合开发者尝鲜。

新手一定要选 LTS 版本！别追求 “最新”，稳定最重要。就像咱们买手机，不会刚出就买首发，等稳定版出来再入手更靠谱。

二、Windows 系统安装步骤：图文详解，小白也能看懂

Windows 用户按这几步来，跟着图操作（如果没图就仔细看文字描述）：

1. 下载安装包

打开 Node.js 官网（nodejs.org），首页就能看到 LTS 版本的 “Download” 按钮，点一下会自动下载适合你电脑的安装包（32 位或 64 位，现在电脑基本都是 64 位）。下载完记得放桌面，好找。

2. 开始安装

双击安装包，会弹出安装界面：

• 第一步点 “Next”；
• 第二步勾选 “我同意协议”，再点 “Next”；
• 第三步选安装路径，默认是 C 盘，不想放 C 盘可以改到 D 盘（比如 D:\Node.js），但路径里别用中文或空格；
• 第四步重点：一定要勾选 “Add to PATH”，这步能自动配置环境变量，省超多事！然后点 “Next”；
• 后面几步直接点 “Next”“Install”，等进度条走完，点 “Finish” 完成安装。

3. 验证是否安装成功

安装完别关窗口，按 Win+R 输 “cmd” 打开命令提示符：

• 输node -v，按回车，能看到版本号（比如 v20.10.0）说明 Node.js 装好了；
• 输npm -v，按回车，看到版本号说明 npm（包管理工具）也没问题。

如果命令行提示 “不是内部或外部命令”，大概率是没勾选 “Add to PATH”，这时候就得手动配置环境变量（网上搜 “Windows Node.js 环境变量配置” 有详细步骤，跟着改就行）。

---

三、Mac 系统安装步骤：和 Windows 略有不同，但同样简单

Mac 用户别慌，步骤比 Windows 还简单点：

1. 下载安装包

同样去 Node.js 官网，点 LTS 版本的 “Download”，下载 “.pkg” 格式的安装包。

2. 开始安装

双击安装包，弹出安装界面后：

• 点 “继续”“同意”；
• 选安装位置（一般默认就行）；
• 输电脑密码授权安装，等进度条走完点 “关闭”。

Mac 会自动配置环境变量，不用手动改，这点比 Windows 方便。

3. 验证安装

打开 Launchpad，找到 “终端” 打开：

• 输node -v和npm -v，能看到版本号就说明成功了。如果没反应，重启终端再试，还不行就搜 “Mac Node.js 安装后命令无效”，有专门的解决办法。

---

四、版本管理工具：nvm 安装，解决多版本兼容问题

如果以后要做多个项目，可能需要不同 Node.js 版本，这时候就得用 nvm（Node 版本管理器），新手可以先装着备用：

1. Windows 用户装 nvm-windows

• 去 GitHub 搜 “nvm-windows”，下载最新的 “setup.exe”；
• 双击安装，选 nvm 安装路径和 Node.js 快捷路径；
• 安装完打开命令行，输nvm version能看到版本号就成功了。

2. Mac/Linux 用户装 nvm

• 打开终端，输curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash（复制这个命令，别手敲）；
• 等安装完，重启终端，输nvm --version能看到版本号就好。

用 nvm 切换版本超简单：nvm install 18.18.0安装 v18，nvm use 18.18.0切换到 v18，以后做项目再也不怕版本不兼容了。

---

五、常见问题自问自答：新手常踩的坑，帮你填好了

问：为什么一定要勾选 “Add to PATH”？PATH 到底是啥？

答：PATH 就像电脑的 “通讯录”，告诉电脑去哪里找程序。勾选后，电脑在任何文件夹都能找到 node 和 npm；没勾选的话，电脑不知道它们在哪，输命令自然没反应。新手一定要勾，省得后面手动改配置。

问：安装完 Node.js，npm 是啥？必须装吗？

答：npm 是 Node.js 自带的包管理工具，就像手机应用商店，能下载别人写好的代码包。做项目肯定要用，不用单独装，安装 Node.js 时会自动带上，所以验证时要查 npm 版本。

问：命令行输 “node -v” 显示版本，但运行代码时报错，怎么回事？

答：可能是代码写错了，或者文件路径不对。先试试写个简单的 “hello.js”，内容console.log("Hello")，命令行进入文件所在文件夹，输node hello.js，能输出 “Hello” 说明环境没问题，是代码的问题。

问：用 nvm 切换版本后，npm 命令突然无效了，怎么办？

答：切换版本后输nvm use 版本号时，确保这个版本已经安装（用nvm list能看到已安装的版本）。如果还不行，重启终端再试，一般都能解决。

---

兔子哥的独家小技巧

环境搭建虽然简单，但细节错了就容易出问题。分享几个新手不知道的小窍门：

• 安装路径别用中文或空格，电脑对中文路径支持不好，容易出奇怪的错；
• 新手别一开始就用 “卸载重装” 解决问题，先看命令行报错信息，大部分问题搜报错文字就能找到答案；
• 定期用npm install -g npm更新 npm，旧版本 npm 可能导致装包失败；
• 如果经常做项目，把 nvm 学会，切换版本比卸载重装方便 10 倍。

其实 Node.js 环境搭建就像给电脑装个软件，步骤不多，重点在勾选 PATH 和选对版本。第一次可能觉得麻烦，多装两次就熟了。环境弄好了，后面学语法、做项目都会顺很多，这步千万别偷懒哦！

标签： Hello World nodejs.org