AI 入门:从零搭建你的第一个 RESTful API(Node.js + Express)
本文教你从零开始安装 Node.js、创建项目、搭建简单 API,并跑通第一个请求。
准备环境:安装 Node.js 和 npm
首先,你需要安装 Node.js(一个让你用 JavaScript 写后端程序的环境)。它自带 npm(用来安装和管理代码库的工具)。
- 访问 nodejs.org,下载 LTS 版本(推荐新手选这个)。
- 双击安装包,一路点“下一步”即可。安装完成后,打开命令行(Win 搜索 cmd,Mac 打开终端),输入
node -v和npm -v,如果看到版本号,说明安装成功。
创建你的第一个项目
接下来,我们新建一个文件夹作为项目目录,并初始化项目。
- 在命令行中执行:
mkdir my-api && cd my-api(创建并进入文件夹)。 - 执行:
npm init -y(快速生成package.json文件,记录项目信息)。 - 安装 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 端口。
运行并验证
- 在命令行中执行:
node app.js。如果看到“Server running on http://localhost:3000”,说明启动成功。 - 打开浏览器,访问
http://localhost:3000,你应该看到“Hello World!”字样。恭喜!你的第一个 API 跑通了。
常见坑与下一步
- 端口被占用:如果 3000 端口被其他程序占用,可以换一个数字,比如 3001,修改代码中的
3000即可。 - 命令找不到:如果提示
node不是内部命令,说明 Node.js 没安装成功,请重新安装并重启命令行。 - 接下来你可以尝试添加更多路由(比如
/users),或者连接数据库保存数据。本教程只带你入门,后续可以继续学习 Express 的更多功能。
内容来源
DEV Tutorial
发布时间
2026-06-12 01:31