mac 开发必备 api 文档与调试工具组合:dash 离线查文档,postman 或 apifox 本地调试,httpie/rapidapi 命令行辅助,raycast 集成工作流,全面提升效率。
mac 上做开发,api 文档和调试工具不是“可选”,而是日常高频刚需。装对了工具,查文档不用切浏览器、调接口不再手写 curl、团队协作也少踩坑。
离线查文档:Dash 是主力
Dash 是 macOS 上最成熟的离线 API 文档工具。它不依赖网络,启动快,支持 Swift、Objective-C、Python、JavaScript、React、Vue、Docker 等上百种技术栈的官方文档,还能导入你自己的 Markdown 或 Docset。
- 安装方式:官网下载 dmg 或通过 Homebrew(
brew install --cask dash) - 首次打开后,在 Preferences → Downloads 中勾选常用文档集(如 iOS SDK、Swift Standard Library、Node.js),一键下载
- 快捷键 Cmd + Shift + D 呼出搜索框,输入任意 API 名(比如
URLSession),秒级定位到官方说明、示例代码、相关类图 - 支持与 VS Code / Xcode / Sublime 等编辑器联动:在代码中选中函数名,按快捷键直接跳转文档
本地调试主力:Postman 或 Apifox 二选一
Postman 老牌稳定,Apifox 更适合国内团队——两者都原生支持 macOS,界面流畅、功能完整,区别在于协作逻辑和中文体验。
macOS 微信消息自动化工具。通过 GUI 自动化实现:发送消息给指定联系人、读取聊天内容、监控新消息。适用于需要自动化微信操作的场景,如定时发送、批量回复、消息备份等。依赖 peekaboo 进行屏幕截图和 UI 交互。仅支持 macOS。开源地址:https://github.com/chairmanmia...
- Postman:适合个人或小团队。重点用好「Collections」分组管理接口、「Environments」切换测试/生产配置、「Tests」写 JS 断言验证响应结构
- Apifox:推荐给有前后端协作或需要自动生成 Mock 的场景。一个接口定义完,自动同步生成文档、Mock 服务、自动化测试用例,还支持中文注释、参数校验规则可视化配置
- 两者都支持从 OpenAPI(Swagger)文件一键导入,避免手动重建请求
终端轻量替代:RapidAPI for Mac 或 HTTPie
不是所有调试都要开 GUI。临时验证一个接口、写脚本批量调用、或者 SSH 连服务器时,命令行工具更直接。
- RapidAPI for Mac:GUI 和 CLI 双模式,支持保存请求历史、导出 cURL 命令、生成 Python/JS 客户端代码,颜值高且完全适配 macOS 手势与快捷键
-
HTTPie:比 curl 更友好的命令行工具(
brew install httpie)。例如:http :3000/api/users id==123自动加 GET、JSON 头、美化输出 - 搭配
jq(brew install jq)可快速解析 JSON 响应,比如http get /posts | jq '.[:3] | map({id, title})'
集成进工作流:Raycast + 插件联动
Raycast 不只是启动器,它能把文档查询、API 调试、环境切换全收进一个快捷键里。
- 装好 Raycast 后,启用官方插件「Dash」,直接输入
d NSURL就查 Dash 文档 - 用「HTTP Request」插件,无需打开 Postman,几秒内发 GET/POST 请求并看响应
- 配合自定义脚本,比如一键切换 Postman 的 staging 环境、清空本地 token、生成当前时间戳参数等
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










