无需编码！json-server 30秒快速搭建假REST API教程
json-server快速搭建假REST API教程：无需编码，30秒即可创建功能完善的模拟API服务。这款轻量级JSON服务器工具支持CRUD操作与数据模拟，有效解决前端等待后端接口的开发瓶颈，帮助开发者高效测试前端交互逻辑，提升开发效率。
json-server：30秒内搭建功能完善的假REST API，前端开发效率神器
在现代前端开发流程中，等待后端API就绪往往是影响开发进度的主要瓶颈之一。作为开发者，你是否曾经因为后端接口未完成而停滞不前？是否需要一个快速的假API来测试前端交互逻辑？json-server正是为解决这些痛点而生的开源工具，它能让你在不到30秒内创建一个功能完整的模拟REST API，无需编写任何后端代码，即可满足前端开发和测试需求。
json-server是什么？解决什么核心问题？
json-server是由typicode开发的一款轻量级JSON服务器工具，自2013年首次发布以来，已积累了74,894+ GitHub星标和7,213+ Fork，成为前端开发社区中最受欢迎的API模拟工具之一。它的核心功能是将一个简单的JSON文件转换为一个功能完善的RESTful API服务，支持标准的CRUD操作、查询参数、排序、分页等高级功能。
在传统开发模式中，前端团队常常需要等待后端接口开发完成才能进行联调，或者手动编写大量模拟数据和临时接口，这不仅降低了开发效率，还可能导致前后端数据结构不一致的问题。json-server通过以下方式解决这些问题：
- 无需后端开发经验，前端开发者可独立创建测试API
- 数据结构完全由JSON文件定义，灵活适配各种业务场景
- 支持RESTful规范的所有核心操作，模拟真实API行为
- 毫秒级启动速度，极大缩短开发准备时间
快速上手：3分钟搭建你的第一个假数据API
使用json-server的门槛极低，即使是新手也能在几分钟内完成从安装到运行的全过程。下面让我们一步步搭建一个简单的假数据API：
安装步骤
首先确保你的环境中已安装Node.js，然后通过npm或yarn安装json-server：
bash
npm install -g json-server
## 或使用yarn
## yarn global add json-server创建数据文件
在项目根目录创建一个名为db.json的文件，定义你的数据结构。例如，一个包含文章和评论的博客数据：
json
{
"posts": [
{ "id": "1", "title": "json-server入门指南", "views": 1560, "author": "前端开发" },
{ "id": "2", "title": "API模拟工具对比", "views": 980, "author": "全栈架构师" }
],
"comments": [
{ "id": "1", "text": "非常实用的工具！", "postId": "1", "userId": "35" },
{ "id": "2", "text": "期待更多高级用法分享", "postId": "1", "userId": "42" }
],
"users": [
{ "id": "35", "name": "张小明" },
{ "id": "42", "name": "李华" }
]
}启动服务器
在命令行中运行以下命令启动json-server：
bash
json-server --watch db.json此时，你将看到类似以下的输出，表明服务器已成功启动：
{^_^}/ hi!
Loading db.json
Done
Resources
http://localhost:3000/posts
http://localhost:3000/comments
http://localhost:3000/users
Home
http://localhost:3000
Type s + enter at any time to create a snapshot of the database
Watching...现在，你可以通过浏览器或API测试工具访问http://localhost:3000/posts，就能看到刚刚定义的文章数据了。一个完整的REST API就这样在30秒内搭建完成！
核心功能详解：不止于简单的假API
json-server虽然上手简单，但功能却十分强大，几乎涵盖了前端开发中需要的所有API模拟场景。以下是其核心功能亮点：
完整的RESTful路由支持
基于你在db.json中定义的数据集合，json-server会自动生成全套RESTful路由：
| 方法 | 路由 | 描述 |
|---|---|---|
| GET | /posts | 获取所有文章 |
| GET | /posts/:id | 获取指定ID的文章 |
| POST | /posts | 创建新文章 |
| PUT | /posts/:id | 替换指定文章 |
| PATCH | /posts/:id | 部分更新文章 |
| DELETE | /posts/:id | 删除指定文章 |
所有操作都会实时更新到db.json文件中，实现了数据的持久化存储。
强大的查询参数
json-server支持多种查询参数，模拟真实API的筛选、排序和分页功能：
-
条件查询：使用
_gt(大于)、_lt(小于)、_like(模糊匹配)等操作符GET /posts?views_gt=1000&author_like=前端 -
排序：使用
_sort指定字段，_order指定排序方向GET /posts?_sort=views&_order=desc -
分页：使用
_page和_per_page实现分页GET /posts?_page=1&_per_page=10 -
关联查询：使用
_embed和_expand获取关联资源GET /posts/1?_embed=comments GET /comments/1?_expand=post
静态文件服务
除了API功能，json-server还可以作为简单的静态文件服务器。只需创建public目录并放入静态文件（如HTML、CSS、JS），访问根路径即可查看：
bash
mkdir public
## 将前端文件放入public目录
json-server db.json这对于快速演示前端项目与模拟API的集成效果非常有用。
自定义配置
通过命令行参数或配置文件，你可以自定义服务器端口、数据文件路径、延迟时间等：
bash
## 自定义端口
json-server db.json --port 4000
## 添加请求延迟（模拟网络延迟）
json-server db.json --delay 1000
## 使用JS文件作为数据源（支持动态数据）
json-server generate-data.js与其他API模拟方案对比：为何选择json-server？
在前端开发中，有多种API模拟方案可供选择，如手动编写mock函数、使用Postman Mock Server、Mockoon等工具。json-server相比这些方案有哪些独特优势？
与手动Mock函数对比
传统的前端Mock通常是在代码中编写模拟数据和拦截请求，这种方式的缺点是：
- 模拟代码与业务代码混合，增加维护成本
- 无法模拟真实网络请求和状态码
- 不支持跨域请求测试
json-server提供了独立的API服务，完全模拟真实后端环境，避免了这些问题。
与专业API工具对比
像Postman Mock Server或Swagger这样的工具功能强大，但学习曲线陡峭，配置复杂，更适合API文档和协作。而json-server：
- 无需任何配置即可使用
- 轻量级（仅依赖几个npm包）
- 启动速度毫秒级
- 完全免费开源
与后端框架快速原型对比
使用Express、Koa等后端框架也能搭建API原型，但需要编写路由、控制器等代码，至少需要几十分钟到几小时。json-server真正实现了