一、Node.js 简介
Node.js 是一个基于Chrome V8引擎的JavaScript运行时环境,采用事件驱动、非阻塞I/O模型,广泛应用于服务端开发、前端工具链构建等场景。其核心优势包括:
- 高性能:V8引擎编译执行JS代码,速度远超传统解释型语言
- 跨平台:支持Windows/macOS/Linux系统
- 生态丰富:npm(Node Package Manager)拥有超过200万个开源库
- 全栈能力:可用于开发Web服务、命令行工具、桌面应用等
二、安装环境准备
1. 版本选择建议
- LTS版本(推荐):点击下载长期支持版(v18.x)稳定性高,适合生产环境
- Current版本:包含最新特性,适合尝鲜开发者
三、详细安装步骤
1. 启动安装向导
双击下载的node-v18.x.x-x64.msi
文件,进入安装界面:
- 勾选 "I accept the terms in the License Agreement"
- 点击Next继续
2. 自定义安装路径
推荐修改默认路径到非系统盘(如D:\DevTools\nodejs
):
- 避免占用C盘空间
- 便于多版本管理
3. 核心组件选择
必须勾选以下组件:
- Node.js runtime(运行环境)
- npm package manager(包管理工具)
- Add to PATH(自动配置环境变量)
4. 完成安装
点击Install开始安装,等待进度条完成后:
- 取消勾选**"Automatically install necessary tools"**(非C++开发者可选)
- 点击Finish退出向导
四、环境验证与配置优化
1. 基础环境检查
打开CMD/PowerShell执行:
node -v # 应显示v18.x.x npm -v # 应显示9.x.x
2. 镜像加速配置
执行以下命令更换淘宝源:
npm config set registry https://registry.npmmirror.com
验证配置:
npm config get registry # 应返回镜像地址
3. 全局模块路径设置(可选)
npm config set prefix "D:\DevTools\nodejs\global_modules"
在系统环境变量中新增:
- 变量名:
NODE_PATH
- 变量值:
D:\DevTools\nodejs\global_modules\node_modules
五、常见问题解决方案
1. 环境变量未生效
现象:命令行提示node不是内部命令
处理步骤:
- 手动添加
安装目录
和global_modules
到Path - 重启终端验证
2. 权限错误处理
现象:安装全局包时出现EACCES
错误
解决方案:
npm install -g --scripts-prepend-node-path=true [包名]
3. 旧版本残留冲突
处理流程:
- 控制面板卸载旧版本
- 删除
C:\Users\<用户名>\AppData\Roaming\npm
- 重新安装最新LTS版本
六、扩展工具链配置
1. 开发工具推荐
工具类型 | 推荐方案 | 官网地址 |
---|---|---|
IDE | Visual Studio Code | Visual Studio Code - Code Editing. Redefined |
包管理工具 | Yarn | Home page | Yarn |
框架脚手架 | Vue CLI / Create-React-App | npm全局安装即可 |
2. 常用全局包安装
npm install -g yarn # 高效包管理工具 npm install -g @vue/cli # Vue项目脚手架 npm install -g typescript # TypeScript编译器
七、结语
本文详细讲解了Node.js LTS版本的安装全流程,涵盖环境配置、镜像加速、故障排查等关键环节。通过本教程,开发者可快速搭建符合企业标准的JavaScript开发环境。
声明:本文所有操作均基于官方正版软件,严禁使用破解工具。镜像服务配置参考淘宝NPM镜像官方文档。