必须使用全英文无空格路径（如D:\Tools\Apifox）安装Apifox，否则启动黑屏或报错Failed to load app config；安装时需以管理员身份运行，避免UAC拦截，并手动指定安装路径，首次启动失败需清理%APPDATA%\Apifox和%LOCALAPPDATA%\Apifox后重试。
要在Windows系统上安装Apifox并立即开始编写接口文档、调试和运行自动化测试，必须避开默认安装路径陷阱，否则启动即黑屏或报错Failed to load app config。
下载与安装前关键准备
访问官网 https://apifox.com 下载 Windows 安装包，不要点击第三方镜像或广告跳转链接——部分捆绑软件会静默植入浏览器劫持组件。
安装前手动创建全英文无空格路径，例如 【D:\Tools\Apifox】；绝对不可使用 C:\Program Files\Apifox 或 D:\我的工具\Apifox 这类含空格/中文路径，这是90%以上启动失败的根源。
右键安装包 → “以管理员身份运行”，避免UAC拦截导致注册表写入不全。
执行安装并验证启动
第一步：双击安装包 → 勾选“I accept the agreement” → 点击“Next”
第二步：在“Choose Install Location”页面，点击“Browse…” → 手动定位到你提前建好的 【D:\Tools\Apifox】 文件夹 → 点击“OK” → 继续“Next”
第三步：保持默认选项（无需勾选“Launch Apifox now”）→ 点击“Install” → 等待进度条走完 → 点击“Finish”
这一步操作起来很简单，直接从开始菜单或桌面快捷方式启动即可；若首次启动卡在白屏或控制台报 IndexedDB open failed，说明旧版本残留未清，需手动删除 %APPDATA%\Apifox 和 %LOCALAPPDATA%\Apifox 两个文件夹后再重试。
首次登录与基础配置
启动后选择“手机号登录”或“邮箱登录”，支持微信扫码快捷登录。
登录成功后自动同步云端项目，无需手动导入；若列表为空，点击左上角“+ 新建项目” → 填写名称、选择协议（HTTP）、设置环境（开发/测试/生产）→ 点击“创建”
创建后进入项目主页，点击“接口管理” → “+ 新建接口” → 输入路径、选择方法、填写请求参数 → 右侧“调试”面板点“发送”即可完成首条接口测试。所有字段支持 Markdown 编辑，文档与测试用例实时联动。
