1. Windows 下 Node.js 安装前的准备工作
在 Windows 系统上安装 Node.js 前,我们需要做好以下准备工作。首先确认你的 Windows 版本,Node.js 支持 Windows 8.1、Windows 10 和 Windows 11 系统。对于 Windows 7 用户,官方已停止支持,建议升级操作系统。
检查系统类型也很重要,打开"设置"→"系统"→"关于",查看系统类型是 32 位(x86)还是 64 位(x64)。虽然 Node.js 提供 32 位和 64 位版本,但现代开发强烈建议使用 64 位版本。
重要提示:如果你的电脑是 32 位系统,只能安装 32 位版本的 Node.js,但需要注意 Node.js 16 是最后一个支持 32 位 Windows 的版本。
2. 下载 Node.js 安装包
访问 Node.js 官方网站(https://nodejs.org/),你会看到两个主要版本选项:
- LTS (长期支持版):当前是 18.x 系列,适合大多数用户
- Current (最新版):包含最新特性,但稳定性可能不如 LTS
对于生产环境或初学者,建议选择 LTS 版本。点击"Windows Installer"下载.msi安装包,文件大小约25MB左右。
如果你需要特定版本,可以访问 https://nodejs.org/dist/ 选择历史版本。下载时注意:
- 根据系统位数选择 x86(32位)或x64(64位)
- .msi安装包比.zip压缩包更方便,会自动配置环境变量
- 企业用户可以考虑下载Windows二进制文件(.zip)进行离线安装
3. 安装 Node.js 详细步骤
双击下载的.msi文件启动安装向导:
3.1 安装向导设置
- 欢迎界面:点击"Next"
- 终端用户协议:勾选接受条款,点击"Next"
- 安装位置:默认是"C:\Program Files\nodejs",除非有特殊需求,否则保持默认
- 自定义安装:选择"Node.js runtime"、"npm package manager"和"Online documentation shortcuts"
- 自动安装必要工具:勾选"Automatically install the necessary tools",这会安装Python和Visual Studio构建工具
3.2 环境变量配置
在安装过程中,最重要的选项是"Add to PATH",确保这个选项被勾选。这样安装程序会自动将Node.js和npm添加到系统环境变量中,让你可以在任何目录下使用node和npm命令。
常见问题:如果安装时忘记勾选"Add to PATH",需要手动添加环境变量:
- 右键"此电脑"→"属性"→"高级系统设置"→"环境变量"
- 在系统变量的Path中添加Node.js的安装路径,如"C:\Program Files\nodejs"
3.3 完成安装
点击"Install"开始安装,可能需要管理员权限。安装完成后,点击"Finish"退出向导。建议勾选"Automatically install the necessary tools"选项,这会安装构建本地模块所需的工具。
4. 验证安装与基本配置
安装完成后,我们需要验证Node.js是否正确安装:
4.1 检查版本
打开命令提示符(cmd)或PowerShell,输入以下命令:
bash复制node -v
npm -v
正常情况会显示类似这样的版本号:
code复制v18.12.1
8.19.2
4.2 配置npm全局安装路径
默认情况下,npm全局安装的包会放在用户目录下。为了避免C盘空间占用过多,我们可以更改全局安装路径:
-
在Node.js安装目录下创建两个文件夹:
- node_global (存放全局包)
- node_cache (npm缓存)
-
设置新的路径:
bash复制npm config set prefix "C:\Program Files\nodejs\node_global"
npm config set cache "C:\Program Files\nodejs\node_cache"
- 将新的全局路径添加到环境变量Path中
4.3 配置npm镜像源
由于网络原因,国内用户建议将npm源切换为淘宝镜像:
bash复制npm config set registry https://registry.npmmirror.com
验证配置是否生效:
bash复制npm config get registry
5. 常见问题解决方案
5.1 安装后命令不可用
如果输入node或npm命令提示"不是内部或外部命令",说明环境变量配置有问题。解决方案:
- 检查Node.js安装路径是否已添加到Path环境变量
- 如果使用VS Code等编辑器,可能需要重启编辑器才能识别新的环境变量
- 确保在安装时勾选了"Add to PATH"选项
5.2 权限问题
在Windows上,有时会遇到EACCES权限错误,特别是在全局安装包时。解决方法:
- 以管理员身份运行命令提示符
- 或者按照前文所述,配置自定义的全局安装路径
- 对于长期开发,建议使用nvm-windows管理Node.js版本
5.3 版本冲突
如果系统中安装了多个Node.js版本,可能会导致奇怪的问题。建议:
- 完全卸载现有Node.js
- 清理npm缓存:
npm cache clean --force - 删除用户目录下的.npmrc文件
- 重新安装需要的版本
6. 进阶配置与工具推荐
6.1 使用nvm-windows管理多版本
对于需要切换不同Node.js版本的开发者,可以安装nvm-windows:
- 先卸载现有Node.js
- 下载nvm-windows安装包:https://github.com/coreybutler/nvm-windows/releases
- 安装后使用命令管理版本:
bash复制nvm list available # 查看可用版本
nvm install 18.12.1 # 安装特定版本
nvm use 18.12.1 # 切换版本
6.2 推荐VS Code扩展
如果使用VS Code进行Node.js开发,建议安装以下扩展:
- ESLint:代码质量检查
- Prettier:代码格式化
- npm Intellisense:npm模块自动补全
- Path Intellisense:路径自动补全
- REST Client:测试API接口
6.3 性能优化
Windows下的Node.js性能有时不如Linux,可以通过以下方式优化:
- 启用Windows子系统Linux(WSL)进行开发
- 使用最新版本的Node.js,性能通常更好
- 对于I/O密集型应用,考虑使用cluster模块利用多核CPU
7. 创建第一个Node.js应用
验证安装后,让我们创建一个简单的Node.js应用:
- 新建一个文件夹,如"myapp"
- 在文件夹中创建app.js文件,内容如下:
javascript复制const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello Node.js!\n');
});
server.listen(3000, () => {
console.log('Server running at http://localhost:3000/');
});
- 在命令行中运行:
bash复制node app.js
- 打开浏览器访问http://localhost:3000,应该能看到"Hello Node.js!"
这个简单示例展示了Node.js创建HTTP服务器的能力。在实际开发中,我们通常会使用Express等框架,但了解底层原理很重要。
