1. Node.js 介绍

1.1 什么是 Node.js？

        Node.js 是一个基于 Chrome V8 引擎 的 JavaScript 运行时环境，让开发者能够使用 JavaScript 编写服务器端应用程序。它采用事件驱动、非阻塞 I/O 模型，使其轻量且高效。

1.2 Node.js 的起源与发展

• 2009年：Ryan Dahl 首次发布 Node.js

• 2010年：npm（Node Package Manager）诞生

• 2011年：微软与 Joyent 合作，将 Node.js 移植到 Windows

• 2015年：Node.js 基金会成立，企业广泛采用

• 至今：成为全球最流行的后端技术之一

1.3 为什么要使用 Node.js？

• 全栈 JavaScript：前后端使用同一种语言，降低学习成本

• 高性能：非阻塞 I/O 和事件驱动机制，适合高并发场景

• 丰富的生态系统：npm 拥有超过 150 万个开源包

• 跨平台：支持 Windows、macOS、Linux 等多种操作系统

• 活跃的社区：拥有庞大且活跃的开发者社区

2. Node.js 环境部署流程

2.1 Windows 系统安装

1. 访问 Node.js 官网

2. 下载 LTS（长期支持版本） 安装包

3. 运行安装程序，按提示操作

4. 勾选 "Add to PATH" 选项

5. 完成安装

2.2 Linux 系统安装

# 方法一：使用 apt
sudo apt update
sudo apt install nodejs npm

# 方法二：使用 NodeSource（推荐，更新版本）
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

3. 测试流程

测试 Node.js 安装

# 检查 Node.js 版本
node --version
# 或简写
node -v

# 检查 npm 版本
npm --version
npm -v

# 检查 npx 版本（Node 包执行器）
npx --version

编写一个 Node.js 程序进行测试

node hello.js

如果能够成果输出，说明node成功安装了！如果没有，请查看下面的问题检查。

4. 常见问题与解决方案

4.1 安装问题

问题1：权限错误（Permission Denied）

# 错误信息
Error: EACCES: permission denied

# 解决方案：
# 方法一：使用 sudo（不推荐长期使用）
sudo npm install -g package-name

# 方法二：修复 npm 权限（推荐）
# 重新安装 npm 并配置正确权限
sudo chown -R $USER:$GROUP ~/.npm
sudo chown -R $USER:$GROUP ~/.npm-global

# 方法三：使用 nvm 管理 Node.js（避免权限问题）

问题2：Node.js 命令找不到

# 解决方案：
# 检查 PATH 环境变量
echo $PATH

# 手动添加 Node.js 到 PATH（Linux/macOS）
export PATH="$PATH:/usr/local/bin"

# Windows：确保安装时勾选了 "Add to PATH"
# 或手动添加到系统环境变量

问题3：版本冲突

# 解决方案：使用 nvm 管理多个版本
nvm install 16
nvm install 18
nvm use 18
nvm alias default 18

4.2 运行问题

问题1：端口被占用

# 错误信息
Error: listen EADDRINUSE: address already in use :::3000

# 解决方案：
# 查找占用端口的进程
# Linux/macOS:
lsof -i :3000
kill -9 <PID>

# Windows:
netstat -ano | findstr :3000
taskkill /PID <PID> /F
# 或修改代码使用其他端口

问题2：内存不足

# 错误信息
FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory

# 解决方案：
# 增加内存限制
node --max-old-space-size=4096 app.js

# 或优化代码，减少内存使用

问题3：模块找不到

# 错误信息
Error: Cannot find module 'express'

# 解决方案：
# 1. 安装缺失的模块
npm install express

# 2. 检查 node_modules 是否存在
ls node_modules/

# 3. 删除 node_modules 重新安装
rm -rf node_modules package-lock.json
npm install

5. 常用指令

# 项目初始化
npm init                  # 交互式初始化
npm init -y               # 快速初始化

# 依赖管理
npm install               # 安装所有依赖
npm install express       # 安装生产依赖
npm install -D jest       # 安装开发依赖
npm uninstall express     # 卸载包
npm update                # 更新所有包

# 脚本运行
npm start                 # 运行 start 脚本
npm run dev               # 运行 dev 脚本
npm test                  # 运行测试

# 包发布
npm login                 # 登录 npm
npm publish               # 发布包
npm version patch         # 更新版本号

# 清理缓存
npm cache clean --force   # 清理 npm 缓存

• 官方文档：Node.js 官网

• 中文文档：Node.js 中文网

• 教程：Node.js 入门教程

• 实战项目：Node.js 最佳实践

6. 总结

        Node.js 是现代 Web 开发的重要工具，掌握其环境配置和测试方法对于全栈开发至关重要。希望通过本文档，可以帮助理解：

1. ✅ 理解 Node.js 的基本概念和优势

2. ✅ 在不同操作系统上成功安装 Node.js

3. ✅ 创建和运行 Node.js 应用程序

4. ✅ 识别并解决常见的问题

5. ✅ 掌握 Node.js 开发的最佳实践

        最后，如果本文对您有所帮助，别忘了点点关注，点点赞！