1. 为什么需要本地安装Node.js和npm?
在开始之前,我们先明确一个基本概念:Node.js是一个基于Chrome V8引擎的JavaScript运行环境,而npm(Node Package Manager)则是随Node.js一同安装的包管理工具。它们共同构成了现代前端开发和服务器端JavaScript开发的基础设施。
你可能已经注意到,很多在线教程会建议使用nvm(Node Version Manager)这样的版本管理工具来安装Node.js。这确实是个不错的选择,但为什么我还要专门写这篇本地安装教程呢?原因有三:
- 系统兼容性:不是所有操作系统都方便使用nvm,特别是在某些企业环境中,权限限制可能让你无法使用这类工具
- 环境纯净:本地安装能给你一个干净、独立的Node.js环境,避免版本管理带来的潜在冲突
- 学习价值:了解原生安装过程能帮助你更好地理解Node.js的运行机制,这对调试和问题排查非常有帮助
我最近在一台全新的Windows企业版电脑上配置开发环境时,就遇到了无法使用nvm的情况。通过这次经历,我整理出了这套全系统适配的安装方法,无论你用的是Windows、macOS还是Linux,都能找到对应的解决方案。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装前的准备工作
2.1 系统要求检查
Node.js对硬件要求不高,但为了确保顺利安装,建议满足以下最低配置:
-
操作系统:
- Windows 8.1及以上(推荐Windows 10+)
- macOS 10.13 (High Sierra)及以上
- 主流Linux发行版(Ubuntu 18.04+/CentOS 7+等)
-
硬件:
- 至少1GB RAM(开发建议4GB+)
- 500MB可用磁盘空间
提示:虽然Node.js能在更低配置上运行,但现代前端项目(特别是使用React/Vue等框架时)往往需要更多资源。
2.2 卸载旧版本(如有)
如果你之前安装过Node.js,建议先彻底卸载旧版本,避免冲突。以下是各系统的卸载方法:
Windows:
- 控制面板 → 程序和功能 → 卸载Node.js
- 手动删除以下目录:
C:\Program Files\nodejsC:\Users\你的用户名\AppData\Roaming\npm
macOS:
bash复制sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules/npm,lib/node,share/man/*/node.*}
Linux:
bash复制sudo apt remove nodejs npm # Ubuntu/Debian
sudo yum remove nodejs npm # CentOS/RHEL
2.3 权限准备
- Windows:确保有管理员权限(安装时需要)
- macOS/Linux:知道sudo密码
- 企业环境:可能需要IT部门协助安装
3. Windows系统安装指南
3.1 下载安装包
访问Node.js官网(https://nodejs.org),你会看到两个版本:
- LTS(长期支持版):稳定,推荐大多数用户
- Current(最新版):包含最新特性,但可能有bug
我建议选择LTS版本,特别是用于生产环境时。点击"Windows Installer"下载.msi文件。
3.2 安装过程详解
双击下载的.msi文件,按以下步骤操作:
- 欢迎界面:直接点击Next
- 许可协议:勾选接受,Next
- 安装位置:默认是
C:\Program Files\nodejs\,除非有特殊需求,否则不要修改 - 自定义安装:这里最关键!
- 确
