ubuntu js如何实现API接口

在Ubuntu上跑Ja vaScript的API接口，其实思路很简单——把Node.js当成运行时环境，再配合Express这类轻量框架，几分钟就能搭起来。下面咱们一步步来，从零开始，走通整个流程。

步骤1：安装Node.js

先别急着写代码，得先把Node.js请进系统。Ubuntu下安装很方便，几条命令就搞定：

sudo apt update
sudo apt install nodejs
sudo apt install npm

装完之后可以用 node -v 和 npm -v 确认一下版本，只要不出错，就算开了个好头。

步骤2：创建项目目录

接下来，找个地方安放你的代码。新建一个文件夹，比如叫 my-api，然后进去：

mkdir my-api
cd my-api

步骤3：初始化项目

项目目录有了，得让 Node.js 知道你打算管理依赖。运行下面这行，它会自动生成 package.json：

npm init -y

-y 参数的意思是所有默认选项都接受，省事儿。

步骤4：安装Express

核心框架登场。Express 是 Node.js 生态里最流行的 web 框架之一，用它写 API 就像搭积木：

npm install express

步骤5：创建API接口

现在到了动真格的时候。在项目根目录里新建一个 index.js 文件，把下面这段代码贴进去：

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;
  if (!name) {
    return res.status(400).json({ message: 'Name is required' });
  }
  res.json({ message: `Hello, ${name}!` });
});

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

这段代码干了三件事：加载 Express、定义两个路由（GET 和 POST）、最后让服务器在 3000 端口监听。GET 接口直接返回一句问候，POST 接口则根据请求体里的 name 字段返回个性化消息——如果没传名字，还会友好提示。

步骤6：运行项目

代码写好了，启动它只需要一个命令：

node index.js

终端里应该会看到一行输出：Server is running on http://localhost:3000。只要没报错，说明服务已经跑起来了。

步骤7：测试API接口

验证成果的时候到了。最简单的办法是用浏览器或 Postman 这类工具。

测试GET接口

打开浏览器，地址栏输入 http://localhost:3000/api/hello，回车后你应该能看到这样的响应：

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

测试POST接口

用 Postman 或者 curl 都可以。这里以 Postman 为例：新建一个 POST 请求，URL 填 http://localhost:3000/api/hello，在 Body 里选择 raw 格式，内容写一个 JSON 对象，比如：

{"name": "Alice"}

发送之后，返回的结果应该是：

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

如果你故意不传 name，就会收到 400 状态码和错误提示——这说明接口的逻辑按预期工作了。

到此为止，你已经成功在 Ubuntu 上搭建了一个最基本的 Node.js + Express API。别小看这个“Hello World”，它背后的框架和思路完全可以支撑更复杂的业务逻辑。想加路由、连数据库、做身份验证？顺着这个基础扩展就行了。