Node.js 安装指南（Windows 版本）

第三部分：安装 Node.js

3.1 启动安装程序

1. 找到下载的 .msi 文件（通常在 "下载" 文件夹中）
2. 双击文件启动安装程序
3. 如果出现用户账户控制（UAC）提示，点击 "是" 继续

3.2 安装向导步骤

步骤 1：欢迎界面

• 阅读欢迎信息
• 点击 "Next" 继续

步骤 2：许可协议

• 仔细阅读最终用户许可协议
• 勾选 "I accept the terms in the License Agreement"
• 点击 "Next" 继续

步骤 3：选择安装位置

• 默认安装路径：C:\Program Files\nodejs\
• 如需更改安装位置，点击 "Change" 按钮
• 建议使用默认路径，除非有特殊需求
• 点击 "Next" 继续

步骤 4：自定义安装选项

这是最重要的步骤，让我们详细了解每个选项：

Node.js runtime

• 必选项，包含 Node.js 运行环境
• 建议：保持选中

npm package manager

• Node.js 的包管理器
• 用于安装和管理 JavaScript 包
• 建议：保持选中

Online documentation shortcuts

• 创建在线文档的快捷方式
• 可选，根据个人需求选择

Add to PATH

• 重要：将 Node.js 添加到系统 PATH 环境变量
• 这允许在任意命令提示符窗口中使用 node 和 npm 命令
• 强烈建议：保持选中

步骤 5：自动安装必要工具

• 这个选项会安装编译本地模块所需的工具
• 包括 Python、Visual Studio Build Tools 等
• 对于初学者，可以取消选中此项
• 如果需要编译 C++ 插件，建议安装

步骤 6：准备安装

• 确认安装设置
• 点击 "Install" 开始安装

3.3 安装过程

1. 安装程序将开始复制文件
2. 显示安装进度条
3. 如果选择了安装必要工具，可能会额外下载约 1GB 的文件
4. 安装时间取决于系统性能和网络速度（通常 2-10 分钟）

3.4 完成安装

1. 看到 "Completed the Node.js Setup Wizard" 表示安装成功
2. 点击 "Finish" 退出安装程序

第四部分：验证安装

4.1 检查 Node.js 安装

1. 打开命令提示符：
   • 按下 Win + R 键
   • 输入 cmd 并按回车
   • 或者搜索 "命令提示符" 并打开
2. 验证 Node.js 版本：

node --version

应该显示类似：v18.12.1 3. 验证 npm 版本：

npm --version

应该显示类似：8.19.2

4.2 测试简单的 JavaScript 代码

1. 打开命令提示符
2. 输入 node 并按回车，进入 Node.js REPL（交互式解释器）
3. 输入以下代码测试：

console.log("Hello, Node.js!");

4. 按回车，应该看到输出：Hello, Node.js!
5. 按 Ctrl + C 两次退出 REPL

4.3 创建并运行第一个 Node.js 脚本

1. 创建一个新文件夹，例如 C:\nodejs-projects\
2. 在该文件夹中创建文件 hello.js
3. 用文本编辑器打开并输入以下内容：

// hello.js
const message = "欢迎来到 Node.js 世界！";
console.log(message);
// 显示当前日期和时间
const currentDate = new Date();
console.log(`当前时间：${currentDate.toLocaleString()}`);
// 简单的计算
const a = 5, b = 3;
console.log(`${a} + ${b} = ${a + b}`);

4. 保存文件
5. 在命令提示符中，导航到文件所在目录：

cd C:\nodejs-projects

6. 运行脚本：

node hello.js

7. 应该看到类似输出：

欢迎来到 Node.js 世界！
当前时间：2023/11/15 14:30:25
5 + 3 = 8

第五部分：配置开发环境

5.1 选择合适的代码编辑器

推荐编辑器：

1. Visual Studio Code（强烈推荐）
   • 免费、开源
   • 优秀的 Node.js 支持
   • 丰富的扩展生态系统
2. WebStorm
   • 付费软件，功能强大
   • 专业的 JavaScript IDE
3. Sublime Text
   • 轻量级，快速
   • 需要安装插件获得完整功能

5.2 安装 Visual Studio Code

1. 访问：https://code.visualstudio.com/
2. 下载 Windows 版本
3. 运行安装程序
4. 选择以下组件：
   • 将 "通过 Code 打开" 操作添加到 Windows 资源管理器文件上下文菜单
   • 将 "通过 Code 打开" 操作添加到 Windows 资源管理器目录上下文菜单
   • 将 Code 注册为受支持的文件类型的编辑器
   • 添加到 PATH

5.3 配置 VS Code 扩展

安装以下有用的扩展：

1. JavaScript (ES6) code snippets
2. npm
3. npm Intellisense
4. Path Intellisense
5. ESLint
6. Prettier - Code formatter
7. Bracket Pair Colorizer
8. Auto Rename Tag

5.4 配置终端

1. 在 VS Code 中打开终端：查看 > 终端 或 `Ctrl + ``
2. 确保终端使用 PowerShell 或命令提示符
3. 测试 Node.js 命令是否正常工作

第六部分：npm 包管理器详解

6.1 npm 基础概念

npm（Node Package Manager）是 Node.js 的包管理器，世界上最大的软件注册表。

主要功能：

• 安装和管理依赖包
• 发布自己的包
• 运行脚本
• 版本管理

6.2 常用 npm 命令

# 初始化新项目
npm init
npm init -y # 快速初始化，使用默认配置

# 安装包
npm install package-name # 安装到 dependencies
npm install package-name --save-dev # 安装到 devDependencies
npm install package-name -g # 全局安装

# 卸载包
npm uninstall package-name

# 更新包
npm update package-name
npm update -g # 更新全局包

# 查看已安装的包
npm list
npm list -g # 查看全局包
npm list --depth=0 # 查看顶层包

# 查看包信息
npm view package-name
npm info package-name

# 运行脚本
npm run script-name

# 审计安全性
npm audit
npm audit fix

6.3 package.json 文件详解

package.json 是 Node.js 项目的核心配置文件：

{
  "name": "my-project",
  "version": "1.0.0",
  "description": "我的 Node.js 项目",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "dev": "nodemon index.js",
    "test": "jest"
  },
  "keywords": ["nodejs", "javascript"],
  "author": "你的名字",
  "license": "MIT",
  "dependencies": {
    "express": "^4.18.2",
    "lodash": "^4.17.21"
  },
  "devDependencies": {
    "nodemon": "^2.0.20",
    "jest": "^29.3.1"
  },
  "engines": {
    "node": ">=18.0.0"
  }
}

6.4 依赖类型说明

dependencies

• 生产环境依赖
• 使用 npm install package-name --save 安装

devDependencies

• 开发环境依赖
• 使用 npm install package-name --save-dev 安装

peerDependencies

• 对等依赖，表明包与宿主环境的关系

optionalDependencies

• 可选依赖，安装失败不会影响主要功能

第七部分：高级配置和优化

7.1 配置 npm 镜像源

由于网络原因，有时需要配置国内镜像源：

使用淘宝 npm 镜像：

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com/
# 恢复官方镜像
npm config set registry https://registry.npmjs.org/
# 查看当前配置
npm config list
# 查看镜像地址
npm config get registry

使用 nrm 管理镜像源：

# 安装 nrm
npm install -g nrm
# 列出可用的镜像源
nrm ls
# 使用淘宝镜像
nrm use taobao
# 测试镜像速度
nrm test

7.2 配置全局安装路径

默认情况下，全局包安装在 %APPDATA%\npm，可以自定义路径：

# 创建全局安装目录
mkdir C:\NodeJS\global_modules
mkdir C:\NodeJS\global_cache
# 配置 npm
npm config set prefix "C:\NodeJS\global_modules"
npm config set cache "C:\NodeJS\global_cache"
# 将路径添加到系统 PATH
# 1. 右键 "此电脑" > "属性" > "高级系统设置"
# 2. 点击 "环境变量"
# 3. 在 "系统变量" 中找到 "Path"，点击 "编辑"
# 4. 添加新路径：C:\NodeJS\global_modules

7.3 环境变量配置

确保以下路径在系统 PATH 中：

• C:\Program Files\nodejs\（Node.js 安装目录）
• C:\Users\你的用户名\AppData\Roaming\npm（全局包目录，如果使用默认设置）

检查环境变量：

echo %PATH%

第八部分：常见问题解决

8.1 安装问题

问题 1：权限错误

Error: EPERM: operation not permitted

解决方案：

• 以管理员身份运行命令提示符
• 或配置自定义全局安装路径

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

'node' 不是内部或外部命令，也不是可运行的程序

解决方案：

• 检查 Node.js 是否安装成功
• 确认安装路径已添加到系统 PATH
• 重启命令提示符或计算机

8.2 npm 相关问题

问题 3：npm 安装超时

npm ERR! network timeout

解决方案：

• 检查网络连接
• 配置国内镜像源
• 增加超时时间：npm config set timeout 60000

问题 4：权限被拒绝

npm ERR! Error: EACCES: permission denied

解决方案：

• 在 Windows 上，以管理员身份运行命令提示符
• 或使用 npm cache clean --force 清理缓存

8.3 版本管理问题

问题 5：需要特定 Node.js 版本

解决方案： 使用 nvm-windows（Node Version Manager for Windows）

# 安装 nvm-windows
# 下载地址：https://github.com/coreybutler/nvm-windows/releases
# 安装特定版本
nvm install 18.12.1
# 使用特定版本
nvm use 18.12.1
# 列出已安装版本
nvm list
# 设置默认版本
nvm alias default 18.12.1

第九部分：开发工具和最佳实践

9.1 推荐开发工具

调试工具：

• VS Code 内置调试器
• Chrome DevTools（通过 --inspect 参数）

进程管理：

• nodemon：自动重启应用

npm install -g nodemon
nodemon app.js

• pm2：生产环境进程管理

npm install -g pm2
pm2 start app.js
pm2 monit

测试框架：

• Jest：JavaScript 测试框架
• Mocha：功能丰富的测试框架
• Chai：断言库

9.2 项目结构最佳实践

my-project/
├── src/ # 源代码目录
│   ├── controllers/ # 控制器
│   ├── models/ # 数据模型
│   ├── routes/ # 路由
│   ├── middleware/ # 中间件
│   └── utils/ # 工具函数
├── tests/ # 测试文件
├── public/ # 静态资源
├── node_modules/ # 依赖包（自动生成）
├── package.json # 项目配置
├── package-lock.json # 依赖锁文件
├── .gitignore # Git 忽略文件
├── README.md # 项目说明
└── app.js # 应用入口文件

9.3 代码质量工具

ESLint - 代码检查工具：

npm install eslint --save-dev
npx eslint --init

Prettier - 代码格式化工具：

npm install prettier --save-dev

Husky - Git 钩子工具：

npm install husky --save-dev
npx husky install

第十部分：创建完整的示例项目

10.1 初始化项目

# 创建项目目录
mkdir my-express-app
cd my-express-app
# 初始化 package.json
npm init -y
# 安装 Express 框架
npm install express
# 安装开发依赖
npm install nodemon --save-dev

10.2 创建基础应用

创建 app.js 文件：

const express = require('express');
const app = express();
const port = 3000;

// 中间件
app.use(express.json());
app.use(express.static('public'));

// 路由
app.get('/', (req, res) => {
  res.json({
    message: '欢迎来到 Express 服务器！',
    timestamp: new Date().toISOString(),
    nodeVersion: process.version
  });
});

app.get('/api/users', (req, res) => {
  const users = [
    { id: 1, name: '张三', email: '[email protected]' },
    { id: 2, name: '李四', email: '[email protected]' },
    { id: 3, name: '王五', email: '[email protected]' }
  ];
  res.json(users);
});

app.post('/api/users', (req, res) => {
  const { name, email } = req.body;
  const newUser = {
    id: Date.now(),
    name,
    email,
    createdAt: new Date().toISOString()
  };
  res.status(201).json(newUser);
});

// 错误处理中间件
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ error: '服务器内部错误！' });
});

// 404 处理
app.use((req, res) => {
  res.status(404).json({ error: '路由未找到！' });
});

// 启动服务器
app.listen(port, () => {
  console.log(`服务器运行在 http://localhost:${port}`);
  console.log(`Node.js 版本：${process.version}`);
});

10.3 配置 package.json 脚本

修改 package.json 的 scripts 部分：

{
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  }
}

10.4 运行项目

# 开发模式（使用 nodemon）
npm run dev
# 生产模式
npm start

访问 http://localhost:3000/ 查看应用运行情况。

总结

通过本详细指南，您已经完成了：

1. ✅ 了解了 Node.js 的基本概念和优势
2. ✅ 下载了合适的 Node.js 版本
3. ✅ 完成了完整的安装和配置过程
4. ✅ 验证了安装结果
5. ✅ 配置了开发环境和工具
6. ✅ 学习了 npm 包管理器的使用
7. ✅ 掌握了常见问题的解决方法
8. ✅ 了解了最佳实践和项目结构
9. ✅ 创建了完整的示例项目

Node.js 生态系统庞大而活跃，继续学习的方向包括：

• 深入学习 Express、Koa 等 Web 框架
• 学习数据库集成（MongoDB、MySQL、PostgreSQL）
• 掌握 RESTful API 设计
• 学习身份认证和授权
• 了解部署和 DevOps 实践