鸿蒙 PC 开发者必读:50+ 篇已发布实战博文精选 —— Qt / Electron / 三方库 / 命令行 全主题导航

欢迎加入开源鸿蒙 PC 社区:https://harmonypc.csdn.net/

本文整理了截至 2026 年 6 月已经在 CSDN 上正式发布的鸿蒙 PC 开发实战博文。所有文章均已通过审核、可直接打开阅读。没有正式博文链接的项目不收录,持续收录中。


在这里插入图片描述

项目信息说明

项目 内容
本文性质 博文导航 / 资源汇总——给开发者一份"想做什么先看哪几篇"的清单
样本来源 OpenHarmony PC 开发者社区已审核通过的实战博文
样本规模 50+ 篇 CSDN 博文(含命令行环境、Qt、Electron、三方库、应用上架)
筛选规则 ✅ 必须有 CSDN 博文链接 · ✅ 审核通过 · ❌ 仅 GitCode/AtomGit 草稿不收录
目标读者 准备做鸿蒙 PC 适配 / 移植 / 开发 的工程师
使用方式 按"我要做的事"先去对应主题章节,挑 1-2 篇最贴近的入手

一、零基础入门:先看这 4 篇打基础

刚拿到鸿蒙 PC 开发任务、不知道从哪入手?先按这 4 篇顺序看完,能省你至少一周的弯路。

推荐顺序 博文 作者 价值
1️⃣ 鸿蒙 PC 生态三方软件移植:开发环境搭建及三方库移植指南 特立独行的猫a 第一篇必读——服务器环境从 0 到 1
2️⃣ 低成本搭建鸿蒙 PC 运行环境:基于 Docker 的 x86_64 服务器 特立独行的猫a 没有阿里云?Docker 方案兜底
3️⃣ HarmonyOS 鸿蒙 PC 端 Qt 应用开发:第三方 Qt 开源软件移植指南 特立独行的猫a Qt 路线总览
4️⃣ 鸿蒙 PC 命令行工具迁移实战 · 四种命令行移植方案详解及对比 dvlinker 命令行路线总览

💡 建议:把 1️⃣ 跑通服务器环境后,根据你目标项目的形态(GUI / 命令行 / Electron)选 3️⃣ 或 4️⃣ 切入。


二、Qt 开源软件移植:12 篇真实跑通案例

2.1 工程视角入门

博文 作者 关键词
HarmonyOS 鸿蒙 PC 的 QT 应用开发:QT 项目运行原理与 EmbeddedUIExtensionAbility 介绍 特立独行的猫a Qt 项目运行原理 + Hello World
HarmonyOS 鸿蒙 PC 开源 QT 软件移植:基于 Qt Widgets 的网络调试助手工具 特立独行的猫a Qt Widgets demo——最小可复现

2.2 中等难度移植案例(Qt + 单一依赖)

博文 作者 项目 难点
Qt 开源软件 DiffPDF 适配鸿蒙 PC 全流程实战 —— 从交叉编译到真机跑通 一键难忘 DiffPDF 第一个完整链路,必读
HarmonyOS 鸿蒙 PC 开源 QT 软件移植:移植开源文本编辑器 NotePad–(Ndd)到鸿蒙 PC dvlinker NotePad– 纯 Qt Widgets 入门
超大日志文件浏览器 glogg 适配鸿蒙 PC 全流程实战 一键难忘 glogg qmake → CMake 重写
NitroShare 适配鸿蒙 PC 全流程实战 — Qt-OHOS × 手把手移植教程 放风铃的兔子 NitroShare 去 SSL + 鸿蒙网络限制
nomacs 开源项目适配鸿蒙 PC 全流程笔记实战 放风铃的兔子 nomacs dlopen 期 symbol-not-found

2.3 进阶移植案例(KDE / 多插件 / qmake)

博文 作者 项目 难点
从 0 到 1:KDiff3 适配鸿蒙 PC 全流程实战 一键难忘 KDiff3 KDE Frameworks 瘦身
鸿蒙 PC:QElectroTech 从零编译到鸿蒙 PC 运行的 10 个阶段 一键难忘 QElectroTech qmake mkspec + 7 处错误修复
开源软件之 LiteIDE x38.4 适配鸿蒙 PC 全流程实战指南教程 放风铃的兔子 LiteIDE qmake + 26 个插件 + ABI 降级(最复杂)

2.4 自研 Qt 实战

博文 作者 项目 价值
鸿蒙 PC 三方库适配实战:从 7-Zip Native 编译到 ArkTS 调用完整跑通 一键难忘 7-Zip native Qt 之外——native 库直接对接 ArkTS

💡 怎么挑:第一次做 Qt 移植 → 选 DiffPDFNotePad–;想挑战 KDE 系 → KDiff3;想啃硬骨头 → LiteIDE


三、Electron 开源软件迁移:8 篇主流应用迁移案例

3.1 环境搭建

博文 作者 价值
鸿蒙 PC:鸿蒙版本 Electron 框架环境搭建并实现 XH 笔记应用 淼学派对 Electron 路线第一篇必读

3.2 主流开源应用迁移实战

博文 作者 项目 难度
electron-markdownify 从普通 Electron 迁移到 OpenHarmony Electron HAP 淼学派对 markdownify ⭐⭐
marktext-develop 鸿蒙适配全记录 淼学派对 MarkText ⭐⭐⭐
鸿蒙 PC 平台 Carnac 按键显示适配实战:从 Windows 到 HarmonyOS 的 Electron 迁移 Dream-Y.ocean Carnac ⭐⭐⭐
鸿蒙 PC 平台 Ristretto 图片查看器适配实战:从 Linux 到 HarmonyOS 的 Electron 迁移 程序山海 Ristretto ⭐⭐⭐
鸿蒙 PC 平台 Gnote 笔记应用适配实战:从 Linux 到鸿蒙 PC 的 Electron 迁移 程序山海 Gnote ⭐⭐⭐

3.3 自研 Electron 实战

博文 作者 项目 价值
Electron 开源框架下实际鸿蒙 PC 应用开发——AI 英语单词记忆卡实战 红目香薰 AI 单词卡 Electron 自研第一案
Windows 鸿蒙 PC 应用开发:Electron 桌面级电子书阅读器开发实战指南 Dream-Y.ocean 电子书阅读器 Electron 重型自研

💡 Electron vs Qt 怎么选:Web 技术栈背景 / UI 复杂度高 → Electron;C++ 背景 / 性能敏感 / 系统级集成 → Qt。


四、三方库移植:20+ 篇 C/C++ 库适配实践

鸿蒙 PC 上做 GUI / 命令行项目几乎绕不开三方库。这一节按"工具/方法论"+"具体库案例"分两类。

4.1 工具链与方法论(先掌握这 8 篇)

博文 作者 核心内容
使用 vcpkg 为鸿蒙(HarmonyOS / OHOS)下载与安装三方库实践指南 特立独行的猫a vcpkg 入门
HarmonyOS 鸿蒙 PC 三方库移植:选 vcpkg 还是 lycium_plusplus?两种"框架化"方案对比 特立独行的猫a 方案选型决策
HarmonyOS 鸿蒙 PC 三方库移植:vcpkg 方式的 Port 脚本编写简明教程 展菲 vcpkg Port 脚本
移植 vcpkg 到鸿蒙 PC:vcpkg-tool 交叉编译与实践手记 dvlinker vcpkg 工具自身移植
HarmonyOS / OpenHarmony 鸿蒙 PC 平台三方库移植:AI 自动化编译框架 build_in_harmonyos 介绍及使用 特立独行的猫a AI 自动化编译
【鸿蒙 PC 三方库构建系统】HPKCHECK 文件详解 坚果 HPK 系列入门
HPKBUILD 深度解读:SHA 库构建的"总指挥" 坚果 HPKBUILD 详解
lycium_plusplus 项目全景解读:OpenHarmony 三方库构建的"大管家" 坚果 lycium_plusplus 全景

4.2 具体 C/C++ 库案例

博文 作者 类型
多媒体信息工具 MediaInfo CLI 的 OpenHarmony 平台迁移实践 wei_shuo MediaInfo 多媒体
HarmonyOS 鸿蒙 PC 平台三方库移植:使用 vcpkg 移植 libzen(ZenLib) 展菲 libzen 基础
OpenHarmony 平台移植 gifsicle:C/C++ 三方库适配实践 特立独行的猫a gifsicle 图像
HarmonyOS / OpenHarmony 平台三方库移植:使用 vcpkg 移植 Crashpad 过程实战总结 特立独行的猫a Crashpad 错误处理
使用 vcpkg 为 OpenHarmony(鸿蒙 PC)构建 OpenSSH 命令行工具 dvlinker OpenSSH 网络/加密
高性能视频渲染库 libplacebo 的 OpenHarmony 平台迁移实践 wei_shuo libplacebo 视频渲染
鸿蒙 PC CodeArts 实战:libplacebo 三方 Native 库编译、签名与调用全流程 wei_shuo libplacebo 从编译到 ArkTS 调用
图像处理框架 G’MIC CLI 的 OpenHarmony 平台迁移实践 Dream-Y.ocean G’MIC 图像处理
跨平台媒体播放器 mpv 的鸿蒙 PC 平台迁移实践 Dream-Y.ocean mpv 多媒体
mpv 多层依赖树完整解析与适配实践 Dream-Y.ocean mpv 依赖 多层依赖方法论
Java 本地访问库 JNA 的鸿蒙 PC 平台迁移实践 程序山海 JNA Java/JNI
Linux 桌面门户服务 xdg-desktop-portal 的鸿蒙 PC 平台迁移实践 程序山海 xdg-desktop-portal 桌面服务
xdg-desktop-portal 多层依赖树完整解析与鸿蒙 PC 适配实践 程序山海 xdg 依赖 依赖树解析
从零开始写 HPKBUILD:以 MediaInfo 为例的三方库 OpenHarmony 适配实战 wei_shuo MediaInfo HPK HPKBUILD 实战
Windows 鸿蒙 PC 应用开发:DevEco Studio 集成与调用三方 Native 库实战指南 wei_shuo Native 调用 DevEco × native

4.3 SHA 库构建系统专题(坚果系列)

适合想深入理解 OpenHarmony 三方库构建机制的读者:

博文 作者
sha_ohos.patch 补丁文件详解 坚果
SHA 库 鸿蒙 PC 适配详解 坚果
sha_ohos.patch 深度解读:一个补丁文件背后的适配故事 坚果

五、命令行工具迁移:4 篇核心方案

博文 作者 价值
鸿蒙 PC 命令行工具迁移实战 · 四种命令行移植方案详解及对比 dvlinker 方案对比——命令行总览
鸿蒙 PC 动态库路径配置方案详解 I’mAllen 动态库路径——必读

💡 命令行工具的核心难点不是编译,是动态库部署——一定先看 I’mAllen 这篇。


六、应用上架实战:1 篇全流程

博文 作者 价值
厨房里的化学生态用鸿蒙 PC 的 Electron 框架实现——上架操作全流程 红目香薰 AppGallery Connect 上架——含真实截图

七、按"我要做什么"快速找答案

我想做的事 优先看哪几篇
服务器环境第一次搭 1️⃣ + Docker 兜底(一节 1-2)
第一个 Qt 移植项目 二节 → DiffPDF / NotePad–
第一个 Electron 移植项目 三节 → markdownify / marktext
三方库不会编(vcpkg / lycium / HPKBUILD) 四节 4.1 全部
C 库依赖很深(多层依赖树) Dream-Y.ocean 的 mpv 依赖 + 程序山海的 xdg 依赖
想自研 Electron 应用并上架 三节 3.3 + 六节上架流程
命令行工具部署后崩溃(动态库找不到) 五节 I’mAllen

八、推荐的作者主页(持续追更)

这些作者持续在做鸿蒙 PC 实战,关注他们的主页能第一时间看到新博文:

作者 CSDN 主页 主攻方向
特立独行的猫a yyz_1987 环境 + Qt + 三方库(产出最多)
dvlinker chenlycly 命令行 + vcpkg + 工具链
wei_shuo weishuo 三方库 + native 调用(C++ 重型)
Dream-Y.ocean dream-yocean 多媒体 + 图像处理 + Electron
程序山海 bigstar 三方库 + Electron 迁移
一键难忘 weixin_52908342 Qt 开源软件移植
放风铃的兔子 mrdeam Qt 移植 + 实战教程
淼学派对 lbcyllqj Electron 环境 + 应用迁移
坚果的博客 jianguo 三方库构建系统(HPK / lycium)
展菲 zhanfei vcpkg 三方库移植
红目香薰 feng8403000 Electron 自研 + 上架

九、写在最后

这份清单截至 2026 年 6 月有 50+ 篇正式发布的博文,覆盖:

  • 4 种主流路线(Qt / Electron / 命令行 / 三方库)
  • 20+ 个真实跑通的项目
  • 10+ 位持续输出的作者

如果你是刚加入鸿蒙 PC 适配的开发者,按本文的"快速找答案表"挑 2-3 篇看完,能省 1-2 周的弯路

如果你已经在路上,欢迎把你的实战记录也写出来——CSDN 上发文章 + 加 鸿蒙PC OpenHarmony 标签,我会持续更新这份清单。

社区的力量从来不是某几个大厂或者明星开发者做出来的,是每一个把自己踩过的坑写下来分享出来的普通人做出来的。


在这里插入图片描述

本文持续更新——遇到新博文、新作者、新主题,欢迎评论区留言补充。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐