很多开发者刚开始会把 SDK 和 API 当成一回事，但实际上它们的层级不同。

一句话概括：

API 是“接口规范”，SDK 是“开发工具包”。

SDK 里面通常包含 API，但 API 不一定有 SDK。

先用一个鸿蒙开发的例子理解

API

例如：

import { router } from '@kit.ArkUI'

router.pushUrl({
  url: 'pages/Detail'
})

这里的：

router.pushUrl()

就是 API。

API定义了：

你传什么参数
我返回什么结果
如何调用

相当于一份能力说明书。

SDK

例如你安装的：

HarmonyOS SDK

里面包含：

• ArkUI API
• Account Kit API
• Push Kit API
• 编译器
• 模拟器
• 调试工具
• 文档
• 示例代码

这些整体才叫：

HarmonyOS SDK

SDK 是开发工具集合。

一个形象比喻

假设你买车：

API

是方向盘、油门、刹车

规定：

踩油门加速
踩刹车减速

属于使用接口。

SDK

是整个汽车维修工具箱

里面有：

扳手
螺丝刀
诊断仪
说明书
维修手册

帮助你造车和修车。

二者关系

通常：

SDK
 ├─ API
 ├─ 示例代码
 ├─ 工具链
 ├─ 文档
 └─ 调试工具

所以：

SDK > API

SDK 是大集合。

API 是其中一部分。

能否互相替代？

一般不能完全替代。

场景1：只有API

例如：

DeepSeek API
OpenAI API
高德地图 Web API

给你的是：

https接口
REST接口

你自己写：

fetch()
axios()
request()

调用。

这种情况：

只有API
没有SDK

完全没问题。

例如：

const res = await fetch(url)

直接调用接口。

场景2：API + SDK

例如：

华为推送

你可以：

直接调用REST API

也可以：

接入 Push Kit SDK

SDK已经帮你封装好了：

认证
签名
错误处理
重试
缓存

开发效率更高。

场景3：只能SDK

例如：

HarmonyOS Camera Kit
ArkUI
Audio Kit

这些能力直接依赖系统框架。

你不可能自己发HTTP请求：

调用相机
调用麦克风
打开Ability

必须依赖 HarmonyOS SDK。

实际开发怎么选？

优先SDK

例如：

华为账号登录
推送
地图
支付

如果官方提供SDK：

优先SDK

原因：

• 文档完善
• 错误处理完整
• 版本兼容性好
• 更新简单

API适合

例如：

AI大模型
天气服务
企业后台
微服务

这类：

HTTP API

反而更灵活。

鸿蒙开发中最容易混淆的一个概念

很多人会说：

HarmonyOS API 23
HarmonyOS API 24

这里的 API 不是接口。

而是：

SDK版本等级

例如：

{
  "targetSdkVersion": "6.1.0(24)"
}

这里的：

API 24

表示：

SDK能力等级

不是：

router.pushUrl()

这种编程接口。

这是鸿蒙、Android里经常让新手混淆的地方。

对于你经常接触的 HarmonyOS 开发来说，可以简单记忆：

所以你在开发中看到：

Map Kit SDK
Push Kit SDK
Account Kit SDK

其实本质上都是：

SDK（工具包）
    ↓
暴露很多API给你调用

这是最准确的理解。