【HarmonyOS】鸿蒙应用开发中常用的三方库介绍和使用示例
截止到2025年，目前参考官方文档：访问 HarmonyOS三方库中心 。梳理了以下热门下载量和常用的三方库。
上述库的组合，可快速实现网络请求、UI搭建、状态管理等核心功能，显著提升开发效率。
版本号以三方库网站上的版本号最新为准。
一、网络与数据交互
1. ohos-axios（网络请求）
ohos-axios：适配 HarmonyOS 的 Axios 版本，支持 HTTP/HTTPS 请求、拦截器、请求取消等，语法与 Web 端 Axios 一致，降低学习成本。
"dependencies": {"@ohos/axios": "1.3.2"
}
import axios from '@ohos/axios';// 基础配置
axios.defaults.baseURL = 'https://api.example.com';
axios.defaults.timeout = 5000;// 发送GET请求
async function fetchData() {try {const response = await axios.get('/user', {params: { id: 123 }});console.log('请求成功:', response.data);} catch (error) {console.error('请求失败:', error);}
}// 拦截器示例
axios.interceptors.request.use((config) => {// 添加Tokenconfig.headers.Authorization = 'Bearer token';return config;},(error) => Promise.reject(error)
);
2. ohos-websocket（实时通讯）
ohos-websocket：封装 WebSocket 客户端，支持长连接、消息监听、断线重连，适用于实时聊天、数据推送场景。
"dependencies": {"@ohos/websocket": "2.1.0"
}
import WebSocket from '@ohos/websocket';// 初始化连接
const ws = new WebSocket('wss://echo.websocket.events');// 连接成功
ws.onopen = () => {console.log('WebSocket连接已打开');ws.send('Hello WebSocket!'); // 发送消息
};// 接收消息
ws.onmessage = (event) => {console.log('收到消息:', event.data);
};// 连接关闭
ws.onclose = (code, reason) => {console.log(`连接关闭: ${code}, ${reason}`);
};
二、UI组件与交互
1. TDesign for HarmonyOS（企业级UI）
腾讯 TDesign 适配 HarmonyOS 的版本，包含企业级 UI 组件，风格统一，覆盖表单、导航、数据展示等场景。
"dependencies": {"@tdesign/arkui-harmonyos": "0.8.5"
}
import { Button, Dialog } from '@tdesign/arkui-harmonyos';
import { Column } from '@arkui-x/components';@Entry
@Component
struct TDesignDemo {@State showDialog: boolean = false;build() {Column() {// primary按钮Button({ type: 'primary', text: '打开弹窗' }).onClick(() => this.showDialog = true)// 弹窗组件Dialog({title: '提示',content: '这是TDesign弹窗',open: this.showDialog,onClose: () => this.showDialog = false})}.width('100%').padding(20)}
}
2. ohos-calendar（日历组件）
高性能日历组件，支持日期选择、范围选择、自定义样式。
"dependencies": {"@ohos/calendar": "3.2.1"
}
import { Calendar } from '@ohos/calendar';
import { Column } from '@arkui-x/components';@Entry
@Component
struct CalendarDemo {@State selectedDate: Date = new Date();build() {Column() {Calendar({startDate: new Date(2024, 0, 1),endDate: new Date(2025, 11, 31),selectedDate: this.selectedDate,onSelect: (date) => {this.selectedDate = date;console.log(`选中日期: ${date.toLocaleDateString()}`);}}).width('90%').height(400)}}
}
三、状态管理
1. ohos-pinia（轻量状态管理）
类似 Vue Pinia 的状态管理库，采用模块化设计，支持 TypeScript 类型推导，更简洁的 API。
"dependencies": {"@ohos/pinia": "2.2.3"
}
import { createPinia, defineStore } from '@ohos/pinia';// 1. 创建Pinia实例
const pinia = createPinia();// 2. 定义Store
const useUserStore = defineStore('user', {state: () => ({name: 'HarmonyOS',age: 3}),actions: {incrementAge() {this.age++;}},getters: {doubleAge: (state) => state.age * 2}
});// 3. 组件中使用
@Component
struct UserInfo {private userStore = useUserStore(pinia);build() {Column() {Text(`Name: ${this.userStore.name}`)Text(`Age: ${this.userStore.age}`)Text(`Double Age: ${this.userStore.doubleAge}`)Button('增加年龄').onClick(() => this.userStore.incrementAge())}}
}
四、数据存储
1. ohos-sqlite（ORM数据库）
"dependencies": {"@ohos/sqlite-orm": "4.1.0"
}
import { Database, Entity, Column, PrimaryGeneratedColumn } from '@ohos/sqlite-orm';// 1. 定义实体类
@Entity('user')
class User {@PrimaryGeneratedColumn()id: number;@Column()name: string;@Column()age: number;
}// 2. 初始化数据库
const db = new Database({name: 'myDB',entities: [User],version: 1
});// 3. 数据库操作
async function dbOperations() {const userRepo = db.getRepository(User);// 插入数据const newUser = new User();newUser.name = 'Test';newUser.age = 20;await userRepo.save(newUser);// 查询数据const users = await userRepo.find();console.log('用户列表:', users);
}
五、工具类
1. ohos-lodash（工具函数）
Lodash 的 HarmonyOS 适配版，提供字符串、数组、对象等常用工具函数（如深拷贝、防抖节流、数据格式化）。
"dependencies": {"@ohos/lodash": "4.17.21"
}
import _ from '@ohos/lodash';// 数组去重
const arr = [1, 2, 2, 3, 3, 3];
const uniqueArr = _.uniq(arr); // [1,2,3]// 深拷贝
const obj = { a: 1, b: { c: 2 } };
const copyObj = _.cloneDeep(obj);// 防抖函数
const debounced = _.debounce(() => {console.log('防抖执行');
}, 500);// 调用防抖函数（连续触发时仅最后一次生效）
debounced();
六、媒体与图形
1. ohos-glide（图片加载）
参考 Android Glide 的图片加载库，支持网络 / 本地图片加载、缓存、裁剪、圆角处理。
"dependencies": {"@ohos/glide": "2.3.0"
}
import { Glide } from '@ohos/glide';
import { Image } from '@arkui-x/components';@Component
struct ImageDemo {build() {Column() {Image().width(300).height(200).onComplete(() => {// 加载网络图片Glide.with(this).load('https://picsum.photos/300/200').placeholder($r('app.media.default_img')) // 占位图.error($r('app.media.error_img')) // 错误图.into(this); // 绑定到当前Image组件})}}
}
