Postman 调试完还要手写文档——Apifox 焊死 API 全生命周期一套数据从设计到测试不走第二遍你是不是也卡在这一步做前后端分离开发接口联调是个噩梦——后端在 Postman 里调通了接口还得转头去写 Swagger 文档两份数据永远不同步前端等后端的接口等得花儿都谢了Mock 数据要自己用 Mock.js 搭一套接口改了一个字段Postman、Swagger 文档、Mock 服务、测试用例全要跟着改一遍团队协作用 Postman免费版不支持团队共享付费版服务器在海外速度感人自动化测试要用 JMeter导入导出一遍数据格式还丢了字段新人入职接口文档散落在三个工具里半天搞不清楚到底以哪个为准如果中了任何一条Apifox 就是你需要的。Apifox 的定位一句话说清楚Postman Swagger Mock JMeter。设计接口文档的同时调试、Mock 数据、自动化测试全部自动就绪——一套系统、一份数据不走第二遍。国产软件全中文界面SaaS 版完全免费不限成员数、项目数、团队数支持私有化部署。传统工具链 Apifox ┌──────────┐ ┌──────────┐ │ 做 API │ │ 做 API │ └────┬─────┘ └────┬─────┘ │ │ ├─→ Postman 调试接口 ├─→ 定义接口文档 ├─→ Swagger 手写文档 ├─→ 调试自动就绪 ├─→ Mock.js 搭 Mock 服务 ├─→ Mock自动生成 ├─→ JMeter 写自动化测试 ├─→ 自动化测试引用接口 ├─→ 四份数据改一个要改四处 ├─→ 一份数据改一次全生效 ├─→ Postman 团队协作要付费 ├─→ 免费协作不限人数 └─→ 工具链切换到怀疑人生…… │ 一套系统全生命周期搞定Apifox vs 其他方案对比维度ApifoxPostmanSwagger UIYApi定位API 全生命周期平台API 调试工具API 文档展示API 管理平台定价免费版不限人数项目免费版不支持团队协作开源免费开源自部署接口调试有功能对标 Postman有行业标杆无仅展示文档有基础功能接口文档有可视化设计需手动维护有OpenAPI 标准有Mock 服务有智能 Mock自动生成有基础 Mock无有基础 Mock自动化测试有可视化编排有JS 脚本无有功能较弱团队协作免费不限人数付费版才支持无免费自部署代码生成130 种语言/框架支持支持支持数据导入20 种格式支持支持支持中文界面全中文英文为主英文中文私有化部署支持不支持支持支持一句话个人调试选 Postman 没问题但只要涉及团队协作、Mock、自动化测试、文档同步Apifox 是国内最省事的选择。YApi 开源免费但功能弱、社区维护停滞Swagger 只能看文档不能调试。一、下载安装——三步搞定第 1 步下载打开浏览器访问 Apifox 官方下载页面https://apifox.com/download/网站会自动识别你的操作系统点击下载对应安装包操作系统安装包格式文件大小约Windows.exe安装程序约 193 MBmacOSIntel.dmg磁盘映像约 315 MBmacOSApple Silicon.dmg磁盘映像约 227 MBLinux.AppImage或.deb约 256 MB不确定你的 Mac 是 Intel 还是 Apple Silicon点左上角苹果菜单 → 关于本机 → 看「芯片」一栏。第 2 步安装Windows双击下载的.exe文件选择安装路径建议默认路径中不要有中文点「安装」等待完成点「完成」启动 ApifoxmacOS双击.dmg文件打开把 Apifox 图标拖到「应用程序」文件夹在「应用程序」中找到 Apifox双击启动首次打开如果提示「无法验证开发者」去「系统设置 → 隐私与安全性」点「仍要打开」Linux# 方式一AppImage推荐免安装chmodx Apifox-*.AppImage ./Apifox-*.AppImage# 方式二deb 包Debian/Ubuntusudodpkg-iapifox_*.deb# 启动apifox第 3 步注册登录首次启动会弹出登录界面点「注册」用手机号或邮箱注册也可以用微信、GitHub、Google 账号直接登录登录后自动创建默认团队和项目免费版不需要任何激活操作登录就能用。不限成员数、项目数、团队数。二、创建第一个项目——从零定义一个接口第 1 步新建项目左侧面板点「」号 →新建项目填项目名称如我的博客 API选择项目类型默认 HTTP 项目点「确定」项目创建后左侧会看到项目结构我的博客 API ├── 接口 │ ├── 文章管理 │ │ ├── 获取文章列表 │ │ ├── 创建文章 │ │ └── 删除文章 │ └── 用户管理 ├── 环境管理 ├── 测试场景 ├── 数据模型 └── 文档第 2 步定义接口左侧右键「接口」→新建接口填写接口信息字段填什么示例接口名称给接口起个名字获取文章列表请求方法选 HTTP 方法GET路径接口 URL 路径/api/posts分组归到哪个文件夹文章管理第 3 步定义请求参数切到「请求参数」标签页以GET /api/posts为例Query 参数参数名类型必填说明示例值pageinteger否页码默认 11page_sizeinteger否每页条数默认 1010keywordstring否搜索关键词DjangoApifox 的参数定义完全可视化不需要手写 YAML 或 JSON。点几下鼠标就能加参数。第 4 步定义响应结构切到「修改响应」标签页 →添加响应→成功 200{code:0,message:success,data:{total:100,list:[{id:1,title:Django 入门指南,content:Django 是 Python 全栈框架……,created_at:2026-08-05T10:00:00Z}]}}定义好响应结构后Apifox 会自动用这个结构做三件事生成 Mock 数据、校验调试返回值、生成文档示例。这就是「一次定义处处复用」。第 5 步保存点右上角「保存」按钮接口定义完成。三、调试接口——和 Postman 一样好用发起请求在左侧接口列表中点开刚才创建的获取文章列表切到「运行」标签页选择环境默认未配置环境可先不选在 Query 参数区填入测试值page1page_size10点「发送」按钮下方显示响应结果请求流程 ┌────────────────────────────┐ │ 打开接口 → 切到「运行」 │ │ ↓ │ │ 填测试参数值 │ │ ↓ │ │ 点「发送」 │ │ ↓ │ │ 响应结果显示在下方 │ │ ↓ │ │ 自动校验返回值是否符合文档 │ │ ✅ 符合 → 绿色 │ │ ❌ 不符合 → 红色标出差异 │ └────────────────────────────┘Apifox 调试时会自动校验返回值是否符合你定义的响应结构。字段缺失、类型错误会直接标红提示——这是 Postman 没有的功能。环境变量管理实际开发中接口地址在开发、测试、生产环境之间切换。Apifox 用环境变量解决左侧点「环境管理」→新建环境填环境名称如开发环境、测试环境、生产环境设置变量变量名开发环境测试环境生产环境base_urlhttp://localhost:8000http://test.example.comhttps://api.example.comtokendev_token_xxxtest_token_xxxprod_token_xxx接口路径里用{{base_url}}/api/posts引用变量顶部下拉框切换环境所有接口自动使用对应地址切换环境后不需要改任何接口参数一个下拉框搞定环境切换。后置脚本接口返回的token要存下来给后续接口用。在后置脚本里写// 自动提取 token 存到环境变量varrespm.response.json();if(res.datares.data.token){pm.environment.set(token,res.data.token);}Apifox 的脚本语法兼容 Postman从 Postman 迁移过来的人零学习成本。四、Mock 服务——接口没写好前端先开工后端接口还没写好前端不想干等。Apifox 内置 Mock 服务定义好接口结构后自动生成 Mock 数据前端直接用。启用 Mock打开一个接口定义切到「修改响应」标签页 →Mock标签Apifox 会根据你定义的响应结构自动生成 Mock 规则Mock 规则示例以文章列表接口为例Apifox 自动生成的 Mock字段Mock 规则生成的假数据示例idinteger(1, 10000)42titlectitle(5, 20)Django 入门指南从零到上线contentcparagraph(3, 10)这是一段自动生成的中文内容……created_atdatetime(yyyy-MM-dd HH:mm:ss)2026-08-05 14:30:00Apifox 的 Mock 支持 Mock.js 语法。ctitle生成中文标题cparagraph生成中文段落integer生成随机整数比手写 Mock 数据省事一百倍。访问 MockApifox 为每个接口生成一个 Mock URLhttps://mock.apifox.com/m1/your-project-id/api/posts前端直接用这个 URL 发请求得到的就是 Mock 数据。后端接口写好后前端把 URL 换成真实地址即可代码一行都不用改。前端开发流程 ┌──────────────────────────────┐ │ 后端没写好接口 │ │ ↓ │ │ Apifox 定义接口结构 │ │ ↓ │ │ Mock URL 自动生成 │ │ ↓ │ │ 前端用 Mock URL 开发 │ │ ↓ │ │ 后端接口写好了 │ │ ↓ │ │ 前端换成真实地址代码不改 │ └──────────────────────────────┘五、自动化测试——可视化编排不用写代码第 1 步创建测试场景左侧点「测试场景」→新建场景填场景名称如文章管理流程测试把左侧接口列表中的接口拖拽到测试场景中排列执行顺序第 2 步编排测试步骤拖入接口后可以为每一步设置设置项说明示例参数值这一步用什么参数请求page1, page_size5前置脚本请求前执行的操作生成时间戳签名后置脚本请求后执行的操作提取返回的 token 传给下一步断言校验返回值是否符合预期code 0且data.total 0断言可以可视化添加不需要写代码。选字段 → 选比较运算符 → 填期望值三步搞定。第 3 步运行测试点「运行」按钮Apifox 按顺序执行所有步骤生成测试报告每步耗时每步断言结果通过/失败总体通过率失败步骤的详细错误信息测试报告可以导出为 HTML 或在线分享链接发给团队看。Apifox CLIApifox 支持命令行运行测试场景方便接入 CI/CD。新版推荐通过界面操作生成命令打开测试场景 → 点「CI/CD」标签页选择要运行的场景复制自动生成的 CLI 命令基本流程# 1. 安装 Apifox CLInpminstall-gapifox-cli# 2. 登录鉴权apifox auth login# 3. 运行测试场景命令在界面 CI/CD 标签页自动生成apifox run --scenario-idscenario-id接入 Jenkins 或 GitHub Actions 后每次提交代码自动跑接口测试不用人工点。六、导入导出——从其他工具迁移导入Apifox 支持 20 种数据格式导入项目设置 →导入数据选择格式OpenAPI/Swagger、Postman、JMeter、YApi、Apipost、RAP2 等上传文件或粘贴 URL确认映射关系后导入从 Postman 迁移最简单Postman 导出 JSON → Apifox 导入 → 完整保留接口、参数、环境变量。导出导出接口数据为标准格式项目设置 →导出数据选择格式OpenAPI 3.0、Markdown、HTML、PDF选择导出范围全部接口或指定分组点击导出导出为 Markdown 或 HTML 就是现成的接口文档直接发给前端或客户。生成代码Apifox 可以根据接口定义自动生成 130 种语言的请求代码打开接口 → 点「修改代码」标签页选择语言Java、Python、Go、TypeScript、Kotlin、Dart、Rust 等自动生成对应的请求代码可直接复制使用常用语言示例# Python requestsimportrequests urlhttp://localhost:8000/api/postsparams{page:1,page_size:10}responserequests.get(url,paramsparams)print(response.json())// JavaScript axiosimportaxiosfromaxios;constresponseawaitaxios.get(http://localhost:8000/api/posts,{params:{page:1,page_size:10}});console.log(response.data);还可以自定义代码模板生成符合你团队架构规范的代码不用手动改格式。七、进阶功能数据模型复用多个接口用到相同的数据结构定义一个「数据模型」到处引用左侧「数据模型」→新建模型定义字段如Post模型id、title、content、created_at在接口的响应结构中引用$ref: Post改Post模型所有引用它的接口自动更新数据库操作商业版功能Apifox 支持在测试中读取数据库数据需商业版授权添加数据库连接MySQL、PostgreSQL、Oracle 等在测试步骤中写 SQL 查询查询结果作为变量传给接口请求也可以用 SQL 断言接口是否真的写入了数据AI 辅助Apifox 2.8.272026 年 5 月起集成了 AI 功能AI 生成接口用自然语言描述需求AI 自动生成接口定义AI 生成测试用例根据接口定义自动生成测试场景和断言AI Agent Debugger可视化调试 AI Agent 的执行过程追踪模型调用链路审计日志商业版组织管理员可查看审计日志追溯成员操作记录包括操作者、事件类型、来源 IP 和时间。适合有合规要求的团队。八、常用快捷键快捷键功能macOS 对应Ctrl S保存接口Cmd SCtrl Enter发送请求Cmd EnterCtrl N新建接口Cmd NCtrl Shift N新建分组Cmd Shift NCtrl F搜索接口Cmd FCtrl E打开环境管理Cmd ECtrl D复制接口Cmd DCtrl K快速搜索全局Cmd KCtrl B切换侧边栏Cmd BCtrl Shift L格式化 JSONCmd Shift L九、常见问题与排坑问题原因解决发送请求报ECONNREFUSED后端服务没启动确认后端服务已运行端口没被占用Mock URL 访问返回 404Mock 没启用或接口没定义响应结构检查接口是否定义了响应Mock 开关是否打开环境变量不生效变量名拼写不一致或没选环境检查{{变量名}}拼写顶部确认选了正确的环境导入 Postman 数据丢失Postman 版本格式不兼容用 Postman Collection v2.1 格式导出自动化测试断言失败断言条件写错或返回值结构变了检查断言字段路径和期望值团队成员看不到项目没有邀请成员或权限没配项目设置 → 成员管理 → 邀请并设角色代码生成格式不符合团队规范没有自定义代码模板设置 → 代码模板 → 自定义模板Apifox CLI 运行报错Node.js 版本太低升级 Node.js 到 16几个容易踩的坑改了接口忘了保存——Apifox 的接口编辑不会自动保存改完要点保存按钮。关窗口不保存会提示但养成习惯更好。Mock 规则和响应结构不一致——修改响应结构后Mock 规则不会自动更新需要手动切到 Mock 标签页刷新一次。环境变量引用了不存在变量——{{token}}引用了一个没定义的变量请求时不会报错但会发送空值。排查时要看请求头里实际发了什么。十、什么情况不该用 Apifox只需要调试一个接口——如果你只是临时发一个 HTTP 请求看看返回什么用curl命令或浏览器装个 REST Client 插件更快不需要装一个 200 MB 的客户端。需要极致性能的压测——Apifox 的自动化测试适合功能验证不适合大规模并发压测。压测用 JMeter 或 k6 更专业Apifox 在这方面不是强项。纯 API 文档展示——如果你只需要把 OpenAPI 文档在线展示给外部看Swagger UI 或 Redoc 更轻量部署一个静态页面就行。团队已经在用 Postman 付费版——如果公司已经买了 Postman Team 版团队也习惯了 Postman 的脚本体系强行迁移成本不低。建议新项目用 Apifox老项目按需迁移。Apifox 的甜区是需要接口文档 调试 Mock 自动化测试一体化、团队协作免费、中文界面的场景。如果你只用 Postman 做个人调试确实没有换的必要——但只要涉及团队协作和 MockApifox 的效率提升是立竿见影的。快捷键速查表操作快捷键 / 路径说明新建项目左侧→ 新建项目HTTP 项目为默认新建接口左侧右键 → 新建接口选方法 填路径发送请求Ctrl EntermacOSCmd Enter运行标签页切换环境顶部下拉框选已配置的环境新建环境左侧环境管理 →设变量和值启用 Mock接口 → 修改响应 → Mock 标签自动生成 Mock 规则新建测试场景左侧测试场景 →拖拽接口编排运行测试测试场景 → 运行生成报告导入数据项目设置 → 导入数据支持 20 格式导出文档项目设置 → 导出数据选 Markdown/HTML/PDF生成代码接口 → 修改代码130 种语言CLI 运行apifox run --scenario-id ID接入 CI/CD核心知识点回顾定位Apifox Postman Swagger Mock JMeter一套系统一份数据解决 API 全生命周期。定价SaaS 版完全免费不限成员数、项目数、团队数私有化部署收费。安装官网下载安装包三步装完登录即用无需激活。核心流程定义接口文档 → 调试自动就绪→ Mock自动生成→ 自动化测试引用接口→ 导出文档。环境变量配好多套环境一个下拉框切换接口路径用{{变量名}}引用。Mock 服务定义好响应结构后自动生成 Mock URL前端直接用后端写好后换地址。自动化测试拖拽接口编排测试流程可视化断言支持 CLI 接入 CI/CD。代码生成根据接口定义自动生成 130 种语言的请求代码。选型建议团队协作和 Mock 选 Apifox个人调试选 Postman纯文档展示选 Swagger UI大规模压测选 JMeter。本文所有操作步骤均经过验证可跟着照做。如有问题欢迎评论区交流。
Postman 调试完还要手写文档——Apifox 焊死 API 全生命周期一套数据从设计到测试不走第二遍你是不是也卡在这一步做前后端分离开发接口联调是个噩梦——后端在 Postman 里调通了接口还得转头去写 Swagger 文档两份数据永远不同步前端等后端的接口等得花儿都谢了Mock 数据要自己用 Mock.js 搭一套接口改了一个字段Postman、Swagger 文档、Mock 服务、测试用例全要跟着改一遍团队协作用 Postman免费版不支持团队共享付费版服务器在海外速度感人自动化测试要用 JMeter导入导出一遍数据格式还丢了字段新人入职接口文档散落在三个工具里半天搞不清楚到底以哪个为准如果中了任何一条Apifox 就是你需要的。Apifox 的定位一句话说清楚Postman Swagger Mock JMeter。设计接口文档的同时调试、Mock 数据、自动化测试全部自动就绪——一套系统、一份数据不走第二遍。国产软件全中文界面SaaS 版完全免费不限成员数、项目数、团队数支持私有化部署。传统工具链 Apifox ┌──────────┐ ┌──────────┐ │ 做 API │ │ 做 API │ └────┬─────┘ └────┬─────┘ │ │ ├─→ Postman 调试接口 ├─→ 定义接口文档 ├─→ Swagger 手写文档 ├─→ 调试自动就绪 ├─→ Mock.js 搭 Mock 服务 ├─→ Mock自动生成 ├─→ JMeter 写自动化测试 ├─→ 自动化测试引用接口 ├─→ 四份数据改一个要改四处 ├─→ 一份数据改一次全生效 ├─→ Postman 团队协作要付费 ├─→ 免费协作不限人数 └─→ 工具链切换到怀疑人生…… │ 一套系统全生命周期搞定Apifox vs 其他方案对比维度ApifoxPostmanSwagger UIYApi定位API 全生命周期平台API 调试工具API 文档展示API 管理平台定价免费版不限人数项目免费版不支持团队协作开源免费开源自部署接口调试有功能对标 Postman有行业标杆无仅展示文档有基础功能接口文档有可视化设计需手动维护有OpenAPI 标准有Mock 服务有智能 Mock自动生成有基础 Mock无有基础 Mock自动化测试有可视化编排有JS 脚本无有功能较弱团队协作免费不限人数付费版才支持无免费自部署代码生成130 种语言/框架支持支持支持数据导入20 种格式支持支持支持中文界面全中文英文为主英文中文私有化部署支持不支持支持支持一句话个人调试选 Postman 没问题但只要涉及团队协作、Mock、自动化测试、文档同步Apifox 是国内最省事的选择。YApi 开源免费但功能弱、社区维护停滞Swagger 只能看文档不能调试。一、下载安装——三步搞定第 1 步下载打开浏览器访问 Apifox 官方下载页面https://apifox.com/download/网站会自动识别你的操作系统点击下载对应安装包操作系统安装包格式文件大小约Windows.exe安装程序约 193 MBmacOSIntel.dmg磁盘映像约 315 MBmacOSApple Silicon.dmg磁盘映像约 227 MBLinux.AppImage或.deb约 256 MB不确定你的 Mac 是 Intel 还是 Apple Silicon点左上角苹果菜单 → 关于本机 → 看「芯片」一栏。第 2 步安装Windows双击下载的.exe文件选择安装路径建议默认路径中不要有中文点「安装」等待完成点「完成」启动 ApifoxmacOS双击.dmg文件打开把 Apifox 图标拖到「应用程序」文件夹在「应用程序」中找到 Apifox双击启动首次打开如果提示「无法验证开发者」去「系统设置 → 隐私与安全性」点「仍要打开」Linux# 方式一AppImage推荐免安装chmodx Apifox-*.AppImage ./Apifox-*.AppImage# 方式二deb 包Debian/Ubuntusudodpkg-iapifox_*.deb# 启动apifox第 3 步注册登录首次启动会弹出登录界面点「注册」用手机号或邮箱注册也可以用微信、GitHub、Google 账号直接登录登录后自动创建默认团队和项目免费版不需要任何激活操作登录就能用。不限成员数、项目数、团队数。二、创建第一个项目——从零定义一个接口第 1 步新建项目左侧面板点「」号 →新建项目填项目名称如我的博客 API选择项目类型默认 HTTP 项目点「确定」项目创建后左侧会看到项目结构我的博客 API ├── 接口 │ ├── 文章管理 │ │ ├── 获取文章列表 │ │ ├── 创建文章 │ │ └── 删除文章 │ └── 用户管理 ├── 环境管理 ├── 测试场景 ├── 数据模型 └── 文档第 2 步定义接口左侧右键「接口」→新建接口填写接口信息字段填什么示例接口名称给接口起个名字获取文章列表请求方法选 HTTP 方法GET路径接口 URL 路径/api/posts分组归到哪个文件夹文章管理第 3 步定义请求参数切到「请求参数」标签页以GET /api/posts为例Query 参数参数名类型必填说明示例值pageinteger否页码默认 11page_sizeinteger否每页条数默认 1010keywordstring否搜索关键词DjangoApifox 的参数定义完全可视化不需要手写 YAML 或 JSON。点几下鼠标就能加参数。第 4 步定义响应结构切到「修改响应」标签页 →添加响应→成功 200{code:0,message:success,data:{total:100,list:[{id:1,title:Django 入门指南,content:Django 是 Python 全栈框架……,created_at:2026-08-05T10:00:00Z}]}}定义好响应结构后Apifox 会自动用这个结构做三件事生成 Mock 数据、校验调试返回值、生成文档示例。这就是「一次定义处处复用」。第 5 步保存点右上角「保存」按钮接口定义完成。三、调试接口——和 Postman 一样好用发起请求在左侧接口列表中点开刚才创建的获取文章列表切到「运行」标签页选择环境默认未配置环境可先不选在 Query 参数区填入测试值page1page_size10点「发送」按钮下方显示响应结果请求流程 ┌────────────────────────────┐ │ 打开接口 → 切到「运行」 │ │ ↓ │ │ 填测试参数值 │ │ ↓ │ │ 点「发送」 │ │ ↓ │ │ 响应结果显示在下方 │ │ ↓ │ │ 自动校验返回值是否符合文档 │ │ ✅ 符合 → 绿色 │ │ ❌ 不符合 → 红色标出差异 │ └────────────────────────────┘Apifox 调试时会自动校验返回值是否符合你定义的响应结构。字段缺失、类型错误会直接标红提示——这是 Postman 没有的功能。环境变量管理实际开发中接口地址在开发、测试、生产环境之间切换。Apifox 用环境变量解决左侧点「环境管理」→新建环境填环境名称如开发环境、测试环境、生产环境设置变量变量名开发环境测试环境生产环境base_urlhttp://localhost:8000http://test.example.comhttps://api.example.comtokendev_token_xxxtest_token_xxxprod_token_xxx接口路径里用{{base_url}}/api/posts引用变量顶部下拉框切换环境所有接口自动使用对应地址切换环境后不需要改任何接口参数一个下拉框搞定环境切换。后置脚本接口返回的token要存下来给后续接口用。在后置脚本里写// 自动提取 token 存到环境变量varrespm.response.json();if(res.datares.data.token){pm.environment.set(token,res.data.token);}Apifox 的脚本语法兼容 Postman从 Postman 迁移过来的人零学习成本。四、Mock 服务——接口没写好前端先开工后端接口还没写好前端不想干等。Apifox 内置 Mock 服务定义好接口结构后自动生成 Mock 数据前端直接用。启用 Mock打开一个接口定义切到「修改响应」标签页 →Mock标签Apifox 会根据你定义的响应结构自动生成 Mock 规则Mock 规则示例以文章列表接口为例Apifox 自动生成的 Mock字段Mock 规则生成的假数据示例idinteger(1, 10000)42titlectitle(5, 20)Django 入门指南从零到上线contentcparagraph(3, 10)这是一段自动生成的中文内容……created_atdatetime(yyyy-MM-dd HH:mm:ss)2026-08-05 14:30:00Apifox 的 Mock 支持 Mock.js 语法。ctitle生成中文标题cparagraph生成中文段落integer生成随机整数比手写 Mock 数据省事一百倍。访问 MockApifox 为每个接口生成一个 Mock URLhttps://mock.apifox.com/m1/your-project-id/api/posts前端直接用这个 URL 发请求得到的就是 Mock 数据。后端接口写好后前端把 URL 换成真实地址即可代码一行都不用改。前端开发流程 ┌──────────────────────────────┐ │ 后端没写好接口 │ │ ↓ │ │ Apifox 定义接口结构 │ │ ↓ │ │ Mock URL 自动生成 │ │ ↓ │ │ 前端用 Mock URL 开发 │ │ ↓ │ │ 后端接口写好了 │ │ ↓ │ │ 前端换成真实地址代码不改 │ └──────────────────────────────┘五、自动化测试——可视化编排不用写代码第 1 步创建测试场景左侧点「测试场景」→新建场景填场景名称如文章管理流程测试把左侧接口列表中的接口拖拽到测试场景中排列执行顺序第 2 步编排测试步骤拖入接口后可以为每一步设置设置项说明示例参数值这一步用什么参数请求page1, page_size5前置脚本请求前执行的操作生成时间戳签名后置脚本请求后执行的操作提取返回的 token 传给下一步断言校验返回值是否符合预期code 0且data.total 0断言可以可视化添加不需要写代码。选字段 → 选比较运算符 → 填期望值三步搞定。第 3 步运行测试点「运行」按钮Apifox 按顺序执行所有步骤生成测试报告每步耗时每步断言结果通过/失败总体通过率失败步骤的详细错误信息测试报告可以导出为 HTML 或在线分享链接发给团队看。Apifox CLIApifox 支持命令行运行测试场景方便接入 CI/CD。新版推荐通过界面操作生成命令打开测试场景 → 点「CI/CD」标签页选择要运行的场景复制自动生成的 CLI 命令基本流程# 1. 安装 Apifox CLInpminstall-gapifox-cli# 2. 登录鉴权apifox auth login# 3. 运行测试场景命令在界面 CI/CD 标签页自动生成apifox run --scenario-idscenario-id接入 Jenkins 或 GitHub Actions 后每次提交代码自动跑接口测试不用人工点。六、导入导出——从其他工具迁移导入Apifox 支持 20 种数据格式导入项目设置 →导入数据选择格式OpenAPI/Swagger、Postman、JMeter、YApi、Apipost、RAP2 等上传文件或粘贴 URL确认映射关系后导入从 Postman 迁移最简单Postman 导出 JSON → Apifox 导入 → 完整保留接口、参数、环境变量。导出导出接口数据为标准格式项目设置 →导出数据选择格式OpenAPI 3.0、Markdown、HTML、PDF选择导出范围全部接口或指定分组点击导出导出为 Markdown 或 HTML 就是现成的接口文档直接发给前端或客户。生成代码Apifox 可以根据接口定义自动生成 130 种语言的请求代码打开接口 → 点「修改代码」标签页选择语言Java、Python、Go、TypeScript、Kotlin、Dart、Rust 等自动生成对应的请求代码可直接复制使用常用语言示例# Python requestsimportrequests urlhttp://localhost:8000/api/postsparams{page:1,page_size:10}responserequests.get(url,paramsparams)print(response.json())// JavaScript axiosimportaxiosfromaxios;constresponseawaitaxios.get(http://localhost:8000/api/posts,{params:{page:1,page_size:10}});console.log(response.data);还可以自定义代码模板生成符合你团队架构规范的代码不用手动改格式。七、进阶功能数据模型复用多个接口用到相同的数据结构定义一个「数据模型」到处引用左侧「数据模型」→新建模型定义字段如Post模型id、title、content、created_at在接口的响应结构中引用$ref: Post改Post模型所有引用它的接口自动更新数据库操作商业版功能Apifox 支持在测试中读取数据库数据需商业版授权添加数据库连接MySQL、PostgreSQL、Oracle 等在测试步骤中写 SQL 查询查询结果作为变量传给接口请求也可以用 SQL 断言接口是否真的写入了数据AI 辅助Apifox 2.8.272026 年 5 月起集成了 AI 功能AI 生成接口用自然语言描述需求AI 自动生成接口定义AI 生成测试用例根据接口定义自动生成测试场景和断言AI Agent Debugger可视化调试 AI Agent 的执行过程追踪模型调用链路审计日志商业版组织管理员可查看审计日志追溯成员操作记录包括操作者、事件类型、来源 IP 和时间。适合有合规要求的团队。八、常用快捷键快捷键功能macOS 对应Ctrl S保存接口Cmd SCtrl Enter发送请求Cmd EnterCtrl N新建接口Cmd NCtrl Shift N新建分组Cmd Shift NCtrl F搜索接口Cmd FCtrl E打开环境管理Cmd ECtrl D复制接口Cmd DCtrl K快速搜索全局Cmd KCtrl B切换侧边栏Cmd BCtrl Shift L格式化 JSONCmd Shift L九、常见问题与排坑问题原因解决发送请求报ECONNREFUSED后端服务没启动确认后端服务已运行端口没被占用Mock URL 访问返回 404Mock 没启用或接口没定义响应结构检查接口是否定义了响应Mock 开关是否打开环境变量不生效变量名拼写不一致或没选环境检查{{变量名}}拼写顶部确认选了正确的环境导入 Postman 数据丢失Postman 版本格式不兼容用 Postman Collection v2.1 格式导出自动化测试断言失败断言条件写错或返回值结构变了检查断言字段路径和期望值团队成员看不到项目没有邀请成员或权限没配项目设置 → 成员管理 → 邀请并设角色代码生成格式不符合团队规范没有自定义代码模板设置 → 代码模板 → 自定义模板Apifox CLI 运行报错Node.js 版本太低升级 Node.js 到 16几个容易踩的坑改了接口忘了保存——Apifox 的接口编辑不会自动保存改完要点保存按钮。关窗口不保存会提示但养成习惯更好。Mock 规则和响应结构不一致——修改响应结构后Mock 规则不会自动更新需要手动切到 Mock 标签页刷新一次。环境变量引用了不存在变量——{{token}}引用了一个没定义的变量请求时不会报错但会发送空值。排查时要看请求头里实际发了什么。十、什么情况不该用 Apifox只需要调试一个接口——如果你只是临时发一个 HTTP 请求看看返回什么用curl命令或浏览器装个 REST Client 插件更快不需要装一个 200 MB 的客户端。需要极致性能的压测——Apifox 的自动化测试适合功能验证不适合大规模并发压测。压测用 JMeter 或 k6 更专业Apifox 在这方面不是强项。纯 API 文档展示——如果你只需要把 OpenAPI 文档在线展示给外部看Swagger UI 或 Redoc 更轻量部署一个静态页面就行。团队已经在用 Postman 付费版——如果公司已经买了 Postman Team 版团队也习惯了 Postman 的脚本体系强行迁移成本不低。建议新项目用 Apifox老项目按需迁移。Apifox 的甜区是需要接口文档 调试 Mock 自动化测试一体化、团队协作免费、中文界面的场景。如果你只用 Postman 做个人调试确实没有换的必要——但只要涉及团队协作和 MockApifox 的效率提升是立竿见影的。快捷键速查表操作快捷键 / 路径说明新建项目左侧→ 新建项目HTTP 项目为默认新建接口左侧右键 → 新建接口选方法 填路径发送请求Ctrl EntermacOSCmd Enter运行标签页切换环境顶部下拉框选已配置的环境新建环境左侧环境管理 →设变量和值启用 Mock接口 → 修改响应 → Mock 标签自动生成 Mock 规则新建测试场景左侧测试场景 →拖拽接口编排运行测试测试场景 → 运行生成报告导入数据项目设置 → 导入数据支持 20 格式导出文档项目设置 → 导出数据选 Markdown/HTML/PDF生成代码接口 → 修改代码130 种语言CLI 运行apifox run --scenario-id ID接入 CI/CD核心知识点回顾定位Apifox Postman Swagger Mock JMeter一套系统一份数据解决 API 全生命周期。定价SaaS 版完全免费不限成员数、项目数、团队数私有化部署收费。安装官网下载安装包三步装完登录即用无需激活。核心流程定义接口文档 → 调试自动就绪→ Mock自动生成→ 自动化测试引用接口→ 导出文档。环境变量配好多套环境一个下拉框切换接口路径用{{变量名}}引用。Mock 服务定义好响应结构后自动生成 Mock URL前端直接用后端写好后换地址。自动化测试拖拽接口编排测试流程可视化断言支持 CLI 接入 CI/CD。代码生成根据接口定义自动生成 130 种语言的请求代码。选型建议团队协作和 Mock 选 Apifox个人调试选 Postman纯文档展示选 Swagger UI大规模压测选 JMeter。本文所有操作步骤均经过验证可跟着照做。如有问题欢迎评论区交流。
)
