apifox启动失败主因是安装路径含中文或空格，windows需全英文无空格路径如d:\tools\apifox，mac需避开空格且选arm64版；web版仅支持文档协作，无本地调试能力；linux需全局安装apifox-cli并确保node.js≥16；升级卡顿多因旧缓存未清，应删除indexeddb与cache目录。
安装路径含中文或空格会导致Apifox启动失败
Windows 用户最常踩的坑就是直接双击安装包、一路“下一步”用默认路径，结果装到 C:\Program Files\Apifox 或带中文名的路径（比如 D:\我的工具\Apifox），启动时黑屏、闪退或报错 Failed to load app config。这不是软件 bug，是 Electron 应用对路径编码的硬性限制。
- 安装前手动指定路径，必须全英文、无空格、无特殊符号，推荐
D:\Tools\Apifox或E:\Apifox - 如果已装错，不要试图改文件夹名——残留注册表和缓存会冲突；应先彻底卸载，再清空
%APPDATA%\Apifox和%LOCALAPPDATA%\Apifox两个目录 - Mac 用户同样需避开含空格路径（如
/Applications/My Tools/Apifox.app），拖入/Applications即可，但注意 Apple Silicon 芯片要选arm64版本安装包，否则运行卡顿
Web版不能替代桌面版做接口调试和Mock
Apifox Web 版（https://apifox.com）登录后能看文档、建项目、协作编辑，但所有涉及本地能力的功能都不可用：无法发起真实 HTTP 请求（没权限访问本地网络）、不能执行 Pre-request Script 或 Test Script、Mock 数据不生效、数据库连接配置灰色禁用。它本质是云端只读视图 + 协作入口。
- 日常调试、写脚本、连本地 MySQL/Redis 做参数化，必须用桌面版
- Web 版适合给测试、产品同学共享文档链接，或出差时临时查看结构，别指望它跑用例
- 桌面版登录后自动同步 Web 端数据，两者项目一致，但功能边界清晰，别混用预期
Linux 安装后命令行调用 apifox-cli 失败
Linux 用户解压安装包后，apifox 可执行文件能图形界面启动，但运行 apifox-cli 报 command not found 是常态——因为安装包不自动写入 $PATH，且 CLI 工具是独立 npm 包，不是桌面版内置组件。
- 先确认是否已全局安装 CLI：
npm install -g apifox-cli，不是从桌面版目录里找二进制 - CLI 依赖 Node.js 16+，运行
node -v检查版本，低于 16 会报语法错误 - 若要用 CLI 运行测试集，必须提前在桌面版里导出项目为
apifox.json，CLI 不读云端项目，只认本地 JSON 文件
旧版本残留导致新版本登录卡在加载页
升级到 v2.7.x 后首次启动卡在“正在加载项目列表”，顶部进度条不动，控制台（DevTools → Console）出现 IndexedDB open failed 或 Cannot read property 'id' of null，基本可判定是旧版缓存未清理干净。
- 关闭 Apifox，打开资源管理器，删除以下两个文件夹：
%APPDATA%\Apifox\IndexedDB和%LOCALAPPDATA%\Apifox\Cache - Mac 对应路径是：
~/Library/Application Support/Apifox/IndexedDB和~/Library/Caches/Apifox - 删完重启，首次加载会慢一点（重建索引），但不会卡死；若仍不行，再检查是否开了代理或企业防火墙拦截了
api.apifox.com
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
