Ubuntu如何使用Node.js构建API接口

在Ubuntu上使用Node.js构建API接口：一份实战指南

想在Ubuntu系统上快速搭建一个API服务？Node.js配合Express框架，堪称是高效上手的黄金组合。整个过程清晰明了，咱们一步步来。

1. 安装Node.js和npm

万事开头先装环境。在Ubuntu上，通过包管理器安装Node.js和npm（Node包管理器）是最直接的方式。打开终端，依次执行下面两条命令：

sudo apt update
sudo apt install nodejs npm

安装完成后，别忘了验证一下。敲入以下命令，如果终端能正确显示出版本号，那就说明安装妥当了。

node -v
npm -v

2. 创建一个新的项目目录

接下来，为你的API项目找个“家”。创建一个专属目录并进入，这是保持代码整洁的好习惯。

mkdir my-api
cd my-api

3. 初始化一个新的Node.js项目

现在，让我们初始化项目。使用npm的初始化命令，可以快速生成一个记录项目依赖和信息的package.json文件。

npm init -y

那个-y参数的意思是默认所有选项，省去了一路回车的麻烦。

4. 安装Express框架

主角登场。Express框架极大地简化了Node.js构建Web应用和API的过程，几乎是这类项目的标配。安装它只需要一行命令：

npm install express

5. 创建一个简单的API接口

环境备齐，开始写代码。在项目根目录下创建一个名为index.js的文件，然后把下面的代码放进去。这段代码做了几件事：引入Express、设置端口、解析JSON数据，并定义了两个最基础的接口。

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

// 中间件来解析JSON请求体
app.use(express.json());

// 定义一个简单的GET接口
app.get('/api/hello', (req, res) => {
  res.json({ message: 'Hello, World!' });
});

// 定义一个简单的POST接口
app.post('/api/hello', (req, res) => {
  const name = req.body.name || 'World';
  res.json({ message: `Hello, ${name}!` });
});

// 启动服务器
app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`);
});

6. 运行你的API服务器

代码写完，是时候让它跑起来了。在终端里运行这个文件，你的第一个API服务器就启动了。

node index.js

如果一切顺利，终端会显示如下信息，告诉你服务已经在本地3000端口就绪：

Server is running on http://localhost:3000

7. 测试你的API接口

服务器跑起来了，但接口到底通不通？测一测才知道。你可以用浏览器测GET请求，用Postman这类工具测POST请求。

测试GET接口

最简单的方法：直接打开浏览器，访问 http://localhost:3000/api/hello。页面上应该会显示一句熟悉的问候：

{ "message": "Hello, World!" }

测试POST接口

对于POST接口，需要发送带请求体的数据。用Postman创建一个指向 http://localhost:3000/api/hello 的POST请求，在Body里选择“raw”和“JSON”，然后输入：

{ "name": "Alice" }

点击发送，你应该会收到一个更具个性化的回复：

{ "message": "Hello, Alice!" }

8. 进一步扩展

恭喜！一个最基础的API已经构建完成。但这仅仅是起点。Express的强大之处在于其丰富的中间件生态和灵活的路由系统。你可以在此基础上，轻松添加用户认证、数据库连接、更复杂的业务逻辑路由，从而构建出功能完善的API服务。

希望这份指南能为你打开Node.js API开发的大门。接下来，就尽情探索和扩展你的项目吧。