极客前沿

AI 入门:从零搭建你的第一个 RESTful API(Node.js + Express)

2026-06-12 01:31
DEV Tutorial
查看原文

本文教你从零开始安装 Node.js、创建项目、搭建简单 API,并跑通第一个请求。

准备环境:安装 Node.js 和 npm

首先,你需要安装 Node.js(一个让你用 JavaScript 写后端程序的环境)。它自带 npm(用来安装和管理代码库的工具)。

  • 访问 nodejs.org,下载 LTS 版本(推荐新手选这个)。
  • 双击安装包,一路点“下一步”即可。安装完成后,打开命令行(Win 搜索 cmd,Mac 打开终端),输入 node -vnpm -v,如果看到版本号,说明安装成功。

创建你的第一个项目

接下来,我们新建一个文件夹作为项目目录,并初始化项目。

Tutorial Image
  1. 在命令行中执行:mkdir my-api && cd my-api(创建并进入文件夹)。
  2. 执行:npm init -y(快速生成 package.json 文件,记录项目信息)。
  3. 安装 Express:npm install express(Express 是一个帮你快速搭建 API 的框架)。

编写第一个 API 接口

在项目文件夹中新建一个文件 app.js,用记事本或代码编辑器打开,输入以下代码:

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

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

这段代码做了三件事:引入 Express、设定一个根路径的响应、让应用监听 3000 端口。

运行并验证

  1. 在命令行中执行:node app.js。如果看到“Server running on http://localhost:3000”,说明启动成功。
  2. 打开浏览器,访问 http://localhost:3000,你应该看到“Hello World!”字样。恭喜!你的第一个 API 跑通了。

常见坑与下一步

  • 端口被占用:如果 3000 端口被其他程序占用,可以换一个数字,比如 3001,修改代码中的 3000 即可。
  • 命令找不到:如果提示 node 不是内部命令,说明 Node.js 没安装成功,请重新安装并重启命令行。
  • 接下来你可以尝试添加更多路由(比如 /users),或者连接数据库保存数据。本教程只带你入门,后续可以继续学习 Express 的更多功能。

内容来源

DEV Tutorial

发布时间

2026-06-12 01:31

返回 AI技术