刚开始搞鸿蒙开发的时候,我完全没料到会有这么多坑等着我跳。本来就想做个简单的个人应用,给家里人用的玩意儿,结果一上来就磕磕绊绊的。
安装开发工具这步就给我卡住
我先从官方那儿下载鸿蒙SDK,手一抖点错了版本,装了老旧的玩意儿。结果编译第一个HelloWorld项目时,IDE就直接给我报红字,说兼容性有问题。这可把我整懵了,我还以为是电脑毛病,重启了好几回。

注意了,别像我一样瞎搞。现在我才明白,一定得核对最新版本号:
- 在IDE设置里,找到SDK Manager
- 下载HarmonyOS的最新版,别点错
- 安装后重启IDE,不然编译工具链会罢工
搞定这一步后,总算能跑通一个小应用了,但坑还没挖完。

编译时报权限错误
我开始往应用里加个拍照功能,调用了鸿蒙的camera API。结果编译通过,跑在模拟器上就立马崩溃了,log里全是“权限拒绝”的字样。我急得直挠头,以为代码写坏了。
翻了好几天社区帖子,才发现是manifest文件漏了配置。赶紧改好文件:
- 在*里,加上这个permission段落
- 别搞错权限名,比如“*”
- 保存后重新编译部署,模拟器上就顺溜工作了
教训太大了,鸿蒙的权限系统和小伙伴不同,每一步都得仔细check清单。
API调用老是抛异常
我寻思加个网络请求功能,用鸿蒙的http模块。代码看着挺顺眼,一运行就给我抛出个“Socket timeout”的报错。我还以为网络问题,换了WiFi也没辙。
后来在论坛潜水问了老鸟,才知道API得用异步方式调用:
- 别在主线程里瞎调用,会阻塞UI
- 改成Promise或callback模式
- 加个超时设置,比如设置5000毫秒
这样一折腾,应用就稳如老狗跑起来了。
总之现在走路顺溜多了
回看这些坑,都怪我自己粗心。鸿蒙社区文档是有的,但新手容易忽略细节。我的教训就是:别急着一头扎进去,先花半天读读官方FAQ,少踩坑保准效率翻倍。如今我做应用快多了,也没以前那么头大。

