Node.js 完全指南：从零开始

2025年10月19日

NEONITY

什么是 Node.js？

想象一下，你在浏览器中写 JavaScript 代码，这些代码只能控制网页的显示和行为。但是，如果有一天你想用 JavaScript 来：

创建网站服务器
读写本地文件
连接数据库
开发桌面应用

传统上，你需要学习其他编程语言（如 Python、Java 等）。但 Node.js 的出现改变了这一切！

Node.js 是一个基于 Chrome V8 JavaScript 引擎构建的 JavaScript 运行环境。它让 JavaScript 不仅能运行在浏览器中，也能运行在服务器端和你的电脑上。这意味着你可以用一种语言（JavaScript）做几乎所有的事情。

Node.js 的特点

跨平台: 支持 Windows、macOS、Linux
高性能: 基于 V8 引擎，执行速度快
丰富的生态系统: 拥有超过 100 万个开源包（npm）
事件驱动: 适合处理大量并发连接

为什么需要 Node.js？

对于初学者来说，学习 Node.js 能带来以下好处：

全栈开发: 用同一种语言开发前端和后端
庞大社区: 遇到问题容易找到解决方案
职业前景: 许多公司和项目都在使用 Node.js
快速原型: 可以快速搭建项目原型

安装 Node.js

方法一：官网下载安装

访问 Node.js 官网
下载适合你操作系统的安装包
- 建议下载 LTS（长期支持）版本，更稳定
运行安装程序，一路点击"下一步"即可
安装完成后，打开终端（或命令提示符），验证安装：

node --version
npm --version

如果显示版本号，说明安装成功！

方法二：使用包管理器安装（推荐）

在 macOS 上使用 Homebrew:

brew install node

在 Linux 上使用包管理器:

# Ubuntu/Debian
sudo apt-get install nodejs npm

# CentOS/RHEL
sudo yum install nodejs npm

在 Windows 上使用 Chocolatey:

choco install nodejs

npm 是什么？

安装 Node.js 后，你会同时获得 npm（Node Package Manager）——世界上最庞大的 JavaScript 代码库和包管理器。

搜索包: 访问 npmjs.com 搜索你需要的包
安装包: 使用 npm install 命令
管理项目: 每个项目都有 package.json 文件记录依赖

创建你的第一个 Node.js 程序

让我们从一个简单的例子开始：

1. 创建项目文件夹

mkdir my-first-nodejs-app
cd my-first-nodejs-app

2. 初始化项目

npm init -y

这会创建一个 package.json 文件，记录你的项目信息。

3. 创建主程序文件

创建 app.js 文件，输入以下代码：

// 引入内置的 http 模块
const http = require('http');

// 创建服务器
const server = http.createServer((req, res) => {
  // 设置响应头
  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
  
  // 返回响应
  res.end(`
    <html>
      <head>
        <title>我的第一个 Node.js 服务器</title>
      </head>
      <body>
        <h1>Hello, Node.js!</h1>
        <p>恭喜你，你已经创建了第一个 Node.js 服务器！</p>
      </body>
    </html>
  `);
});

// 监听端口 3000
server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000');
});

4. 运行程序

node app.js

然后在浏览器中访问 http://localhost:3000，你就能看到"Hello, Node.js!"的页面！

实用示例：文件操作

Node.js 内置的 fs 模块可以读写文件。创建一个 file-demo.js 文件：

const fs = require('fs');

// 写入文件
fs.writeFile('hello.txt', '你好，Node.js！', (err) => {
  if (err) {
    console.error('写入文件失败:', err);
    return;
  }
  console.log('文件写入成功！');
  
  // 读取文件
  fs.readFile('hello.txt', 'utf8', (err, data) => {
    if (err) {
      console.error('读取文件失败:', err);
      return;
    }
    console.log('文件内容:', data);
  });
});

运行 node file-demo.js，你会看到创建了 hello.txt 文件并读取了它的内容。

使用第三方包

Node.js 的强大在于庞大的包生态系统。让我们尝试安装和使用一个流行的包。

安装 Express（流行的 Web 框架）

npm install express

创建 express-demo.js：

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

// 路由：处理根路径
app.get('/', (req, res) => {
  res.send('<h1>欢迎使用 Express！</h1>');
});

// 路由：处理 /about 路径
app.get('/about', (req, res) => {
  res.send('<h1>关于我们</h1><p>这是一个简单的 Express 应用</p>');
});

// 启动服务器
app.listen(3001, () => {
  console.log('Express 服务器运行在 http://localhost:3001');
});

运行 node express-demo.js，访问 http://localhost:3001 查看效果！

其他有用的包

nodemon: 自动重启服务器（开发时很有用）

npm install -g nodemon
nodemon app.js  # 代替 node app.js

dotenv: 管理环境变量
```
npm install dotenv
```
axios: 发送 HTTP 请求
```
npm install axios
```

调试技巧

使用 console.log()

最简单的调试方法：

console.log('这是一个日志');
console.error('这是一个错误');
console.warn('这是一个警告');

使用 debugger

在代码中插入 debugger 语句，然后使用：

node --inspect app.js

在 Chrome 浏览器中打开 chrome://inspect 进行调试。

下一步学习方向

现在你已经了解了 Node.js 的基础知识，建议你继续学习：

Express.js: 最流行的 Node.js Web 框架
异步编程: 理解 Promise 和 async/await
数据库连接: 学习连接 MongoDB、MySQL 等
RESTful API: 设计和构建 API
身份验证: 实现登录和授权功能
测试: 学习使用 Jest 或 Mocha 编写测试
部署: 了解如何将应用部署到 Heroku、Vercel 等平台

学习资源

官方文档: nodejs.org
npm 文档: npmjs.com
MDN 指南: developer.mozilla.org
实践项目: GitHub 上有很多开源项目可以作为学习参考

记住，编程是一个实践的过程。多写代码，多尝试，遇到问题就搜索解决方案。相信自己，你一定能掌握 Node.js！

祝你编程愉快！🚀