【开发者开发鸿蒙pc的故事】我在咖啡馆把笔记本合上，决定给鸿蒙 PC 做点东西
欢迎加入开源鸿蒙 PC 社区：https://harmonypc.csdn.net/
一、那杯咖啡的故事
去年秋天我换了台华为 MateBook Pro。
新机器到手那天我挺高兴，国产 PC、鸿蒙系统、屏幕是真的漂亮——2.5K、护眼、合上就睡眠、打开就秒醒。我发了个朋友圈：「再见 macOS。」
然后我用了三天。
第四天我在公司楼下咖啡馆改一份合同。客户那边发来一个新版 PDF，我习惯性想找一个工具——把新旧两版打开并排比对哪些地方改了。这个工具我用了 5 年，叫DiffPDF——免费、轻量、专门干这件事，红色高亮删掉的、绿色高亮加上的，一目了然。
我打开应用市场。搜 “DiffPDF”。没有。
搜 “PDF 对比”。有几个广告联盟做的工具，全是月度订阅 ¥29。
我换思路，搜 “对比”。出来一堆"语音对比"“视频对比”“图片对比”——就是没有 PDF 对比。
我去问 AI 客服：“请问鸿蒙 PC 上有没有 PDF 文件对比工具？”
AI 礼貌地说：“您可以在文件管理器中分别打开两个 PDF 文件进行查看。”
我愣了两秒，把笔记本合上。
那天回家路上我一直在想这件事——不是 DiffPDF 这一个工具的问题。我打开 macOS 时代的 Dock，鸿蒙 PC 上一个都没有。
不是它们多伟大，是它们刚好覆盖了一个普通中年程序员日常的所有缝隙——比对、看图、看日志、传文件、画图、记数据、扩剪贴板。这些在 Linux 桌面用了十几年的免费小工具，鸿蒙 PC 上全不在。
我想了想，发现一个事实：
这些工具都是用 Qt 写的。
那一瞬间我心里那根弦"啪"地一下绷起来了。
Qt 是我吃饭的家伙。我做了 10 年 Qt 桌面开发。Qt 应用上鸿蒙 PC 这件事——理论上没有任何不可逾越的障碍：Qt 5.12 已经有华为版本了，鸿蒙 PC 就是 Linux 内核 + ArkUI 壳，跑 Qt 应用就是跑一个 .so 而已。
没人做不是因为做不了，是因为这件事既不挣钱、又麻烦、又没人催。
那晚我打开服务器，开始第一次 cmake configure。
二、为什么我没把笔记本退掉
在动手之前其实我犹豫过——退货是能退的，七天无理由。但有几件事让我没退：
第一件事：我妈在视频里说"你那个新电脑挺漂亮的，国产的吧？"——她从来不关心我用什么品牌，那次特意问了一句。我回了个嗯。挂了电话之后我看着这台 MateBook 想，这是她第一次因为"国产"这两个字关心我用什么电脑。
第二件事：朋友圈那条"再见 macOS"下面有个老同学留言："我也想换，但是我用 KDiff3 改公司合同，鸿蒙 PC 上有吗？"我没回他，因为我也不知道。后来我发现答案是没有——但他和我一样，是真的想用国产系统。
第三件事——也是最重要的——我在写代码这件事上有点理想主义。我相信桌面操作系统不是只有 Windows 和 macOS。Linux 桌面理想化了三十年没成，是因为它从来不在意"我妈也能用"。鸿蒙 PC 的不一样在这——它一上来就要面对几亿用户，它必须能用、必须好用、必须把我妈的需求和我的需求一起照顾到。
我不能既相信这件事、又因为没有 DiffPDF 把笔记本退掉。
那就，去做 DiffPDF。
三、第一个工具：从一个具体的不爽开始
我没有"做一系列工具"的宏大计划。第一个目标就是 DiffPDF——因为那天在咖啡馆我没用上它。
我给自己定了一个朴素的标准：让我下次比对合同时，在鸿蒙 PC 上能用上。
第一个周末，我从早上 10 点开始，到凌晨 3 点 17 分DiffPDF 在我的 MateBook 上跑起来了。中间踩了至少 4 个我后来才知道叫"工具链问题"的坑，写了一个修 ELF 文件的 Python 脚本，骂了两次"这玩意是给开发者用的吗"，喝了 3 杯黑咖啡。
但凌晨 3 点 17 分屏幕上那个小窗口蹦出来时——我把上周客户发的两版合同拉进去，红绿高亮一下子全出来了——我没欢呼，也没拍照，就是看着它，特别安静地坐了几分钟。
那种感觉很难描述。不是技术成就感，是生活的某一小块缝隙被自己亲手补上了——明天早上去咖啡馆我就能用，再也不用靠 AI 客服建议我"分别打开查看"。
那一刻我决定：接着做。
四、做的过程中我开始懂一件事
第一个工具 DiffPDF 用了 17 小时。
是因为那条路被我自己走平了。
走平的过程中我意识到一个比"做工具"更有意思的事——
我做的不只是 工具，我在不知不觉中给鸿蒙 PC 这个生态铺出了一条"通用 Qt 应用适配路径"——任何一个 Qt 桌面应用，按照我趟出来的这条路，1-3 天就能搬上鸿蒙 PC。
这意味着什么？
意味着如果再有一个像我一样的开发者，他不用熬到凌晨 3 点写fix_elf_align.py，不用花 4 小时搞清楚 host moc 5.15 vs target moc 5.12 的 ABI 错位——
他可以直接接上我这条路，把他自己生活里那 10 个工具搬上去。
这就是开源生态的魔力——1 个人趟出来的路，10000 个人能走。
我开始把每一个项目都写成详细的文章，把每一个坑都记下来，把每一个修复脚本都开源到仓库。不是为了博眼球，是因为我希望我下面那个 N 个开发者能跑得比我快 10 倍。
如果我半年做 10 个，10000 个开发者每人做 1 个，那就是 10000 个 Qt 应用上鸿蒙 PC——几乎等于把整个 Linux 桌面应用生态搬过来。
那时候我妈的电脑上想要什么有什么，咖啡馆里我合上笔记本之前能把合同改完，朋友圈里那个老同学的留言下面我可以回他：“有了，去市场搜 KDiff3。”
五、对鸿蒙 PC 的几个真心话
做了半年，我有一些想跟鸿蒙 PC 团队（华为的同事，可能正在看这篇文章的某位）说的话——不是吐槽，是我作为第一批"自己掏钱买、自己花周末适配"的开发者的真实感受。
第一：Qt-OHOS 工具链请尽快出 Linux host 版本。moc.exe这种东西在 Linux 服务器上跑不了——我们自己软链系统 Qt 是临时方案，长期不可持续。Qt 5.15.x for OHOS 出 6.x 的时候，请把这件事修了，整个开发者社区会感谢你们。
第二：4KB 页对齐已经在新版修了，谢谢。但请把这件事写进官方文档——现在很多老资料还在说要跑fix_elf_align.py，新人会被绕进去。
第三：HAP 自动签名的"两步走"设计反人类。signingConfigs写好了不自动 patch 到products[i].signingConfig——我和我帮过的 5 个开发者全部踩过这个坑。请改成"自动签名 = 一键完成所有事"。
第四：应用市场对"工具类小应用"的审核请放宽一点。我做的 DiffPDF / KDiff3 这些工具没有"杀手级功能"——它们的价值是填缝隙。如果审核标准是"必须很有创新"，那这种工具永远进不来——而没有它们鸿蒙 PC 桌面体验就永远缺一块。
第五——也是最想说的——
请相信开发者社区。
鸿蒙 PC 桌面生态不会靠华为内部团队全部做完，也不会靠几个大厂的 KA 客户做完。它会靠几万个像我一样的、自己花周末时间、为了让自己的电脑用得舒服一点而做点东西的普通开发者做完。
请给我们留一条容易走的路——把工具链做好、把文档写清楚、把审核标准放宽、把开发者支持做扎实——剩下的交给社区。
我们这群人已经在路上了。
六、写给可能正在路上的你
如果你也在用鸿蒙 PC，也遇到过"想用某个工具但没有"的瞬间，也是个会写代码的人——
我想跟你说：
那个瞬间不是失落，是机会。
那个你没找到的工具——可能你周末投入 1-3 天就能把它搬过来。从此你自己用得爽，全网用鸿蒙 PC 的人也都能用得爽。
我趟过的所有坑都写在这个仓库里了——8 大坑、7 条铁律、5 类 Checklist——不是为了让你佩服我多熬夜，是为了让你不用再熬一遍。
直接接上我的路，做你自己生活里那个工具。
如果你做完了，请把它发出来——我会去下一个。
如果你做的过程中卡在某个坑里——发到社区里，我会回。
如果你还没动手但有那个念头——
那就动手。
这是一个普通程序员在 2025 年秋天因为一杯咖啡的不痛快，做了Qt 应用搬上鸿蒙 PC 的故事。
故事还没完——下一个是你。
