必须避开中文路径、空格和特殊符号，下载解压至全英文路径（如D:\Tools\Apifox），安装后登录或启用离线模式，创建项目并配置开发/测试/生产三环境，定义接口后可自动Mock与编写自动化测试用例。
要在Windows系统上完成Apifox的安装与全流程接口管理配置，必须避开中文路径、空格和特殊符号导致的启动失败，同时完成账号同步、环境变量、项目结构和调试闭环等关键环节。
下载与安装Apifox
访问Apifox官网（https://apifox.com），在下载页面选择【Apifox-windows-latest.zip】——这是适配Windows 64位系统的最新稳定版，覆盖Win10/Win11，绝大多数开发机应选此项。
解压压缩包到一个全英文、无空格、无中文、无特殊符号的路径，例如：D:\Tools\Apifox；切勿使用默认的C:\Program Files\Apifox或含“我的”“软件”等中文名的路径，否则启动时将黑屏或报Failed to load app config错误。
进入解压目录，双击运行Apifox-*.exe安装程序，点击“下一步”→勾选“创建桌面快捷方式”→点击“安装”，等待进度条结束。
安装完成后不立即启动，先确认D:\Tools\Apifox目录下存在resources\app.asar等核心文件，再双击桌面图标启动。
首次登录与离线模式启用
启动后若网络正常，直接使用微信/手机号/邮箱登录即可，数据自动同步至云端。
若处于内网或断网环境，登录界面不会加载，此时需主动触发离线模式：等待5秒无响应后，界面底部会浮现“跳过登录，进入离线模式”链接，点击它。
注意：离线模式下可新建项目、编辑接口、发送本地请求、运行Mock服务，但无法同步云端项目、拉取团队协作变更、使用API Token导出文档。如需长期离线使用，须提前在联网机器上登录一次，并记录下该账号绑定的设备指纹。
创建项目并配置多环境
登录（或进入离线模式）后，点击左上角【新建项目】，输入名称如“订单中心-API”，类型选【HTTP项目】，点击创建。
进入项目后，点击左侧边栏【环境管理】→【+ 新建环境】，依次添加：
① 开发环境：Base URL填http://localhost:8080/api，变量token留空或设为{{dev_token}}占位；
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案，可稳定把窗口收进托盘且不闪控制台。
② 测试环境：Base URL填https://test-api.example.com/v1，勾选“启用SSL证书验证”；
③ 生产环境：Base URL填https://api.example.com/v1，务必勾选“禁用此环境下的Mock服务”，防止误调真实支付接口。
这三套环境配置完毕后，任意接口右上角的环境切换器即可实时生效，请求头、URL、证书策略全部联动变更。
定义接口并发起调试
在项目根目录或某分类文件夹（如“用户模块”）上右键→【新建HTTP接口】。
方法一：手动填写
在中间编辑区，请求方法选POST，URL输入{{base_url}}/users/login（自动引用当前环境的base_url），Headers里添加Content-Type: application/json，Body选raw→JSON，输入登录参数：{"username":"admin","password":"123456"}。
方法二：从cURL导入
复制浏览器Network面板中某次真实登录请求的cURL命令，点击右上角【Import】→【cURL】→粘贴→确定，Apifox自动解析URL、Method、Headers、Body，连Cookie都保留。
点击蓝色【发送】按钮，右侧响应区立刻显示状态码、响应头、格式化JSON响应体；若返回401，检查Headers中是否漏了Authorization字段；若返回502，说明base_url指向的服务未启动。
基于接口自动生成Mock与测试用例
打开刚创建的登录接口，在右侧切换到【Mock】标签页，点击【启用Mock】，无需任何配置——Apifox已根据你定义的请求参数和响应示例，自动生成可直接调用的Mock地址：https://mock.apifox.com/m1/xxxxx-xxxxx-xxxxx/users/login。
前端开发时，把请求URL替换为该Mock地址，即可在后端接口未就绪时联调登录流程。
切换到【自动化测试】标签页，点击【+ 新建用例】，用例名称填“登录成功-200”，在Pre-request Script中写一行：pm.environment.set("timestamp", Date.now());，在Test Script中写断言：pm.test("Status code is 200", function () { pm.response.to.have.status(200); });。
保存后点击【运行】，选择“开发环境”执行，结果面板将显示通过/失败详情，支持导出HTML报告。
