从鸿蒙小白到独立开发上架应用，这6个月我踩过的坑、学到的技术、总结的经验，希望能给你一些参考

开篇：为什么选择学习鸿蒙

说实话，我接触鸿蒙是从2024年初开始的，当时完全是个新手。

之前一直做Android开发，但总觉得Android生态太成熟了，想找点新的方向。正好那段时间鸿蒙NEXT开始预热，我就想，要不试试？

刚开始心里其实挺没底的，毕竟是全新的技术栈。但后来想想，既然要学，不如边学边做个项目，这样印象更深刻。于是就有了后来那个开发者工具箱的想法。

这篇文章，我想完整复盘一下这6个月的学习历程，包括我的学习路线、踩过的坑、以及一些实用的经验。希望能给想学鸿蒙的朋友一些参考。

第一阶段：入门摸索（第1-2周）

我的学习路径

一开始完全不知道从哪里学起，在网上搜了一圈，最后确定了这个路线：

1、官方文档是第一手资料：先把HarmonyOS官方文档过了一遍，虽然有点枯燥，但很多基础概念必须从这里理解

2、跟着Codelabs动手：官方的Codelabs很适合入门，每个案例都可以跑起来，很有成就感

3、看视频教程辅助理解：B站上找了几个口碑不错的鸿蒙教程，配合文档一起看

第一个坑：ArkTS不是TypeScript

这个坑我印象特别深。

因为之前用过TypeScript，看到ArkTS就以为差不多，结果调试的时候各种报错。后来才明白，ArkTS虽然基于TypeScript，但有很多限制，比如不支持某些ES6特性、有严格的类型检查等。

避坑建议：别想当然，老老实实看官方的ArkTS语言规范，把不支持的特性记下来。

第一周的小成果

跟着官方教程做了几个Demo：

· Hello World应用（虽然简单，但理解了项目结构）

· 简单的Todo List（学会了状态管理@State）

· 网络请求Demo（了解了鸿蒙的HTTP模块）

说实话这一周挺枯燥的，但打基础很重要。我把每个Demo的代码都敲了一遍，虽然慢，但理解更深刻。

第二阶段：实战启动（第3-8周）

确定项目：做一个开发者工具箱

学了两周理论，说实话有点枯燥了，手痒得很，特别想做点实际的东西。

记得那是个周五晚上，凌晨2点多还在调试一个网络问题。手机上想测个ping，结果发现没合适的工具。当时就在想，这鸿蒙应用市场上怎么连个像样的开发者工具都没有？

然后灵光一闪：既然没有，那我自己做一个不就行了？

说干就干！第二天周末，我就在几个开发者群里发了个问卷：“大家平时开发都用哪些工具？最需要哪些功能？” 结果反响还挺热烈的，收到了一堆回复。光是整理这些需求，我就花了一整天，最后统计出来20多个功能点。

技术选型与学习

有了需求，接下来就是技术选型了。

UI框架：ArkUI

这个没啥好纠结的，鸿蒙就用ArkUI。刚开始学的时候，最头疼的就是声明式UI的思维转换。以前做Android习惯了命令式，现在要适应声明式，脑子有点转不过来。

比如这段代码，我刚开始看着就晕：

后来慢慢理解了：状态变了，UI自动更新，不用手动去改UI。这个思想理解透了，后面开发就顺多了。

这块我大概花了一周时间，把@Component、@State、@Prop这些装饰器搞清楚了。官方文档来回看了好几遍，社区的案例也翻了个遍。

数据存储方案

数据存储这块纠结了好久。

本地配置用Preferences轻量级存储，这个比较简单，就是个键值对存储，用起来跟SharedPreferences差不多。

但跨设备同步数据就麻烦了。一开始想自己搭服务器，算了算成本，还要运维，太麻烦了。后来发现华为有CloudDB云数据库，试了试，发现还真不错。

不过CloudDB的学习曲线有点陡，光是权限配置就搞了我两天。什么Zone、ObjectType、同步模式，一堆概念，看得我头都大了。

网络请求

网络请求倒是简单，用的@ohos.net.http，跟其他平台的HTTP库差不多。

但有个坑要注意：网络权限要在module.json5里配置，我第一次忘配了，调试了半天才发现是权限问题，真是哭笑不得。

关键知识点攻克

1. 状态管理体系

状态管理这块，真的是我学习过程中最头疼的部分。

以前用React和Vue，习惯了它们的状态管理方式。鸿蒙这套完全不一样，刚开始真的一脸懵。

最基础的是@State，这个还好理解：

但父子组件通信就有点绕了，@Prop是单向的，@Link是双向的，经常搞混：

还有全局状态，用@Provide和@Consume，这个概念更抽象。

我踩过的坑：

第一个坑是修改数组的问题。有一次我直接用push往数组里加数据，结果UI死活不更新。debug了好久，后来才知道，@State修改数组要用整体替换：

第二个坑是@Link传参。我以为什么都能传，结果传基本类型的值就报错。后来才明白，@Link只能传引用类型。

第三个坑是跨页面传数据。一开始用路由参数传对象，结果数据丢了。群里大佬告诉我，复杂对象要用AppStorage，这样才靠谱。

2. 页面路由与生命周期

路由这块倒是比较简单，跟其他框架差不多：

不过有个地方要注意：页面栈管理。有一次我一直pushUrl，结果页面栈堆了好多，内存直接爆了。后来学聪明了，该用replaceUrl的时候就用replaceUrl，别啥都用push。

3. 权限申请

权限这块，真的是坑王之王！

刚开始做网络请求，死活调不通，后来才发现网络权限没配置。要在module.json5里加上：

配置完重新编译，才能用。这个坑我踩了好几次，每次都要重新编译，浪费好多时间。

更坑的是敏感权限，比如相机、位置这些，光配置还不行，还得动态申请：

有一次做二维码扫描功能，相机权限没动态申请，结果一直闪退。debug了一下午，最后发现是权限问题，真是欲哭无泪。

经验总结：

· 网络、存储这些普通权限，配置文件里声明就行

· 相机、位置、通讯录这些敏感权限，必须写代码弹窗让用户同意

· 不同鸿蒙版本、不同设备，权限可能不一样，要做好兼容

· 权限被拒绝后，要给用户友好提示，别直接闪退

这个阶段的成果

5周时间过去了，基础功能总算是做出来了：

· 系统工具模块：查设备信息、看系统状态，这些比较简单

· 网络工具模块：Ping测试、扫端口、测网速，这些是我自己最常用的

· 数据处理模块：加解密、MD5、各种格式转换，工具人必备

· 基础UI框架：导航、主题切换、收藏夹这些

说实话界面还挺粗糙的，但至少能跑起来了。第一次在真机上跑起来的时候，那种成就感，真的没法形容。

记得那天晚上，我把第一个可用版本安装到手机上，兴奋地打开每个功能试了一遍。虽然界面丑了点，bug也不少，但毕竟是自己从零开始做出来的东西，特别有成就感。

还特意拍了个视频发朋友圈，结果被好几个做开发的朋友问"什么时候能用"，哈哈。

第三阶段：深入优化（第9-16周）

性能优化学习

应用能跑了，但新问题来了：卡！

特别是在朋友的低端机上，打开列表直接卡死。我拿着他手机试了下，确实卡得不行，完全没法用。那一刻脸都丢光了，赶紧回家改代码。

找资料学优化

性能优化这块，我也是从零开始学。主要参考了这些资料：

· 官方的性能优化指南（写得挺全面的）

· CSDN上一些大佬的优化案例（特别实用）

· 华为开发者论坛（遇到具体问题就来这里搜）

学到的优化技巧

1、懒加载是救命稻草

以前我是一次性把所有数据都渲染出来，列表长了自然就卡。后来学会了LazyForEach，只渲染可见区域的数据：

这个改完后，列表再长也不卡了。早知道就早点用了！

2、组件复用

之前不知道有@Reusable这个装饰器，每次滚动列表都在创建销毁组件，能不卡吗？

学会用@Reusable后，组件可以复用了，滑动列表的流畅度提升明显。

3、图片要压缩

有一次用户反馈说应用占内存太大。我一查，好家伙，都是图片的锅。图片没压缩，一张就好几MB，内存能不爆吗？

后来学聪明了：

· 大图一定要压缩

· 用Image组件的renderMode优化渲染

· 图片用完记得释放

4、预加载能提速

应用启动慢也是个问题。学了预加载机制后，在启动时提前把常用数据加载好，打开速度快了好几倍。

用户都说：“哎，你这应用怎么突然变快了？” 我心里暗爽，哈哈。

鸿蒙特色功能接入

这个阶段开始接入一些鸿蒙独有的能力。

1. 服务卡片开发

服务卡片是鸿蒙的特色功能，我做了几个实用卡片：

· 设备信息卡片

· 网络监控卡片

· 快捷工具卡片

学习要点：

· 卡片有独立的生命周期

· 数据更新要用FormProvider

· 卡片大小有限制，UI要精简

踩坑记录：

· 卡片不能直接访问网络，要通过主应用

· 更新频率有限制，不能太频繁

· 调试比较麻烦，要多看日志

2. 华为账号登录

集成账号服务，实现跨设备同步。

这块官方文档很详细，按步骤来基本没问题。主要是配置比较繁琐，要在AppGallery Connect后台设置。

3. 多端适配

适配手机、平板、PC三端，这个真的是大工程。

核心思路：

· 用响应式布局（GridRow、GridCol）

· 根据设备类型调整UI密度

· 不同设备提供不同的交互方式

代码示例：

这部分我连续加班了一周，测试了各种设备，最后终于搞定。

云服务接入：从零开始学云开发

这个阶段还有个重要的学习内容：华为云服务的接入。

为什么要学云服务？

工具箱要实现跨设备同步，用户在手机上收藏的工具，换到平板上也能看到。一开始我想自己搞个服务器，但算了算成本，还要运维，太麻烦了。

后来发现华为有云数据库和云函数服务，试了试，发现真香！

云数据库简介

还记得以前做项目的时候，最头疼的就是数据库服务器的维护和运维。有一次半夜服务器突然宕机，我爬起来处理到天亮，结果发现就是个简单的配置问题。现在有了华为的云数据库，这些问题都解决了。它不仅能帮我们实现数据在客户端和云端之间的同步，还支持离线访问，开发效率提升了不少。最重要的是，再也不用半夜爬起来处理服务器问题了，哈哈。

这里说个有意思的事，我们项目最开始用的是本地模式，结果用户反馈说换手机后数据就没了。后来改成缓存模式，用户都说好用多了。

云数据库的功能还挺丰富的：

· 同步模式很灵活：可以用缓存模式（数据自动从云端缓存到本地）或者本地模式（只存本地，不同步）

· 查询功能强大：支持各种条件查询、排序、分页，基本够用了

· 实时同步：数据改了能实时推送到各个设备，这个功能特别实用

· 离线也能用：没网的时候也能访问本地数据，有网了自动同步，用户体验好

· 安全性不错：数据全程加密，权限控制也挺细的

云函数简介

云函数就更方便了，完全不用操心服务器的事情。记得之前做项目，光是服务器配置就花了好几天时间。有一次为了配置服务器，我连续工作了36个小时，最后发现配置错了，又得重来。现在有了云函数，我们只需要关注业务逻辑的开发，其他的事情都交给华为云来处理，省心又省钱。而且按量计费，用多少算多少，再也不用担心服务器资源浪费了。

云函数的好处就是：

· 不用管服务器：代码写好了上传就行，服务器配置、部署、扩容这些都不用操心

· 可以连接其他服务：能调用云数据库、云存储这些服务，组合起来实现各种功能

支持的触发方式有：

· HTTP触发：客户端发个请求就能触发

· 数据库触发：数据库有变化时自动触发

· 自定义触发：根据自己需求配置

云数据库学习过程

第一次接触云数据库时，完全不知道怎么用。看了官方文档，发现概念挺多的：

· 存储区（Zone）

· 对象类型（ObjectType）

· 同步模式（缓存模式、本地模式）

我当时就懵了，这都是啥？

然后就一点点啃文档，跟着示例代码敲。第一个Demo跑起来花了我两天时间，中间遇到各种问题：

· 配置文件不知道怎么写

· 权限设置搞不明白

· 数据模型定义有问题

第一次踩坑：数据模型定义错误

记得特别清楚，我定义用户信息模型时，少写了字段类型映射方法。结果数据存进去全是乱的，查出来也对不上。

调试了一整天，最后发现是这个问题：

云函数的学习曲线

云函数更有意思了，它相当于服务器端代码，但不用自己管服务器。

学习流程是这样的：

1、在AGC控制台创建云函数项目

2、本地写代码，实现业务逻辑

3、配置触发器（HTTP、数据库触发等）

4、上传部署，客户端调用

第二次踩坑：云函数调用失败

第一次调用云函数时，死活调不通。返回错误信息也看不懂，整个人都不好了。

后来在论坛求助，发现是权限配置的问题。云函数的 function-config.json 里要配置认证方式：

数据库操作封装

为了方便使用，我把所有数据库操作都封装起来了。记得有一次项目上线，数据库操作没有做好封装，结果代码到处都是重复的数据库操作，改一个地方要改好多处，真是累死个人：

完整的云函数实现

云函数的主要处理逻辑，这里我们处理了增删改查这些基本操作。有一次我忘记处理异常情况，结果用户数据丢失了，被用户投诉了好久，所以错误处理一定要做好：

客户端调用示例

在登录成功后，我们需要把用户信息同步到云端，这个在实际项目中经常用到。有一次我忘记处理登录失败的情况，结果用户一直登录不上去，被用户骂惨了：

客户端调用起来就很简单了，就像上面那个例子一样。

云服务学习心得

经过这段时间的实践，总结几点经验：

1、先跑通官方Demo：别直接上手自己的项目，先把官方案例跑一遍

2、理解核心概念很重要：存储区、对象类型、权限这些要搞清楚

3、错误处理要做好：网络可能失败，数据库操作可能出错，都要处理

4、多看日志：遇到问题先看日志，大部分问题都能从日志里找到线索

5、参考社区案例：官方文档有时候不够详细，多看看社区的实战案例

开发建议总结：

数据模型设计：

· 用TypeScript类定义，有代码提示，不容易出错。我就因为类型定义没做好，debug了两天

· 字段类型映射一定要实现，不然数据存进去会乱。我就吃过这个亏

· 主键和索引要设置好，不然查询慢得要死。我们项目就因为这个，查询慢得像蜗牛

· 数据验证要做好，防止脏数据。有一次用户输入特殊字符，把数据库搞崩了

错误处理：

· 用 try-catch 捕获错误，这个很重要。我就因为没做好，程序经常崩溃

· 错误日志要记录详细，方便排查。有一次线上出问题，没日志，排查了好久

· 错误提示要友好，别让用户看不懂。我们产品经理就经常吐槽错误提示太技术化

· 网络不好的时候要有重试机制。我就因为没加重试，用户数据同步失败了好多次

性能优化：

· 合理用缓存，能省流量。我们项目加了缓存后，流量费用降了一半

· 批量处理数据，效率高很多。有一次我优化了批量处理，性能提升了10倍

· 查询条件要优化，别查太多没用的数据。我就因为查太多，把服务器搞崩了

· 同步频率要控制，别太频繁。有一次同步太频繁，用户手机都搞没电了

安全性：

· 访问控制要做好，别让不该访问的人访问。我们项目就被人恶意访问过

· 敏感数据要加密，比如密码。我就因为没加密，被安全部门警告了

· 用https，别用http。有一次用http，数据被截获了

· 数据验证要做好，防止注入攻击。我们项目就被SQL注入过

常见问题处理：

云函数调用失败：

遇到调用失败，先检查这些：

· 网络是否正常，有时候就是网络问题。我就因为网络问题，调试了一整天

· 云函数配置对不对，特别是权限设置。有一次权限配错了，调用了半天

· 参数格式对不对，这个经常出错。我就因为参数格式不对，debug了好久

· 权限别开太大，有一次权限开太大，差点出安全问题

数据同步问题：

同步出问题，检查这些：

· 数据模型定义对不对，字段类型要对。我就因为类型不对，同步失败

· 主键设置要合理，别重复了。有一次主键重复，数据全乱了

· 权限够不够，有时候就是权限问题。我就因为权限不够，改不了数据

· 数据格式对不对，特别是日期格式。有一次日期格式不对，同步失败

性能问题：

遇到性能问题，可以这样优化：

· 查询条件要优化，别查太多数据。我就因为查太多，把服务器搞崩了

· 数据要分页，一次别查太多。有一次没分页，查询超时了

· 加索引，查询会快很多。加了索引后，查询速度提升了100倍

· 控制数据量，别存太多没用的。有一次存了太多图片，存储空间用完了

云服务带来的好处

接入云服务后，好处太明显了：

· 不用自己管服务器，省心省钱

· 跨设备同步很方便，用户体验提升明显

· 按量计费，小项目几乎不花钱

· 安全性有保障，华为帮你做好了

预加载优化实践

说实话，刚开始做这个项目的时候，我们并没有太重视预加载这个问题。直到有一天，产品经理拿着用户反馈来找我："用户说打开应用要等好久，体验太差了！"我一看评分，直接降到了3分以下。这才意识到问题的严重性。

后来我们团队花了两周时间专门优化这个问题。通过引入预加载机制，不仅提升了用户体验，还意外地发现了一些性能优化的机会。

经过多次尝试和优化，我们最终选择了安装预加载这种方式：

这段代码看起来简单，但实际开发中踩了不少坑。比如最开始没有做好错误处理，导致预加载失败时应用直接崩溃。后来加了错误处理，又发现日志记录不够详细，排查问题特别费劲。

预加载的几点经验：

· 数据要分片处理：别一次性传太多数据。有一次我们传了1000多条图标数据，服务器直接超时了。后来改成每次传50条，速度快了，还稳定。

· 错误处理要做好：日志要详细，失败了要给用户友好提示。记得有一次线上出问题，用户反馈说应用闪退，我们查了半天才发现是预加载失败导致的。

· 别重复加载：我们会在应用启动时检查上次预加载的时间，如果间隔太短就不重复加载，省资源。

实际项目经验：

我们项目里，预加载主要用在这几个地方：

· 图标资源预加载：启动时预加载系统图标，显示速度快了很多。用户反馈说图标加载明显快了。

· 用户数据预加载：登录后预加载用户信息，不用等数据加载了。这个功能上线后，用户登录体验好多了。

· 图片资源预加载：预加载常用图片，打开图片基本不用等。我们项目里有个图片预览功能，预加载后体验特别好。

这个阶段的收获

技术能力提升了不少：

· 掌握了性能优化的方法

· 学会了鸿蒙特色功能开发

· 积累了多端适配经验

· 学会了云服务开发

· 理解了Serverless架构

更重要的是，学会了系统性地解决问题，知道怎么用云服务简化开发。

第四阶段：完善上架（第17-24周）

应用测试与调试

测试用的工具：

· DevEco Studio的调试工具

· Profiler性能分析

· 真机测试（借了好几部不同型号的手机）

发现的问题：

· 内存泄漏（某些页面退出后没释放）

· 崩溃问题（空指针、异常处理不到位）

· 兼容性问题（不同系统版本表现不一致）

一个一个解决，过程很磨人，但也学到很多。

上架流程学习

上架流程是全新的知识，从零开始学：

· 应用签名：配置证书、Profile文件

· 隐私合规：隐私声明、权限说明

· 应用审核：准备截图、描述、审核材料

踩坑经历：

· 第一次提审被拒，隐私声明不完整

· 第二次又被拒，某个权限没说明用途

· 第三次才过，学到了很多审核要求

文档撰写与分享

同步在CSDN、掘金写技术文章，分享开发经验：

· 《鸿蒙ArkTS状态管理完全指南》

· 《鸿蒙性能优化实战：从卡顿到流畅》

· 《鸿蒙服务卡片开发避坑指南》

写文章的过程也是对知识的二次整理，收获很大。文章阅读量累计10万+，还认识了很多同行朋友。

我的学习经验总结

回顾这6个月，总结几点经验：

1. 学习路线建议

第1-2周：打基础

· 官方文档必读（至少通读一遍）

· Codelabs跟着做（动手很重要）

· 掌握ArkTS语法和ArkUI基础

第3-8周：实战项目

· 选一个实际项目练手

· 边做边学，遇到问题再查文档

· 加入开发者社区，多交流

第9-16周：深入学习

· 系统学习性能优化

· 掌握鸿蒙特色功能

· 研究优秀开源项目

第17周+：持续精进

· 关注新特性、新API

· 参与社区讨论和分享

· 尝试更复杂的项目

2. 必备学习资源

官方资源：

· HarmonyOS开发者官网（最权威）

· DevEco Studio文档

· Codelabs实战教程

· AppGallery Connect文档（云服务必看）

· 华为云服务开发指南（云函数、云数据库）

社区资源：

· 华为开发者论坛（遇到问题先来这里搜）

· CSDN鸿蒙专区（有很多实战案例）

· 51CTO、掘金等平台（技术文章质量不错）

· 鸿蒙云服务交流群（加群能认识很多大佬）

视频教程：

· B站上的鸿蒙系列教程

· 官方直播课程

· 云服务实战系列（推荐看，很实用）

3. 常见坑及避坑指南

4. 提升效率的技巧

善用工具：

· DevEco Studio的代码补全很智能

· 使用代码片段（Live Templates）

· 快捷键提高效率

建立知识库：

· 我建了个笔记本，记录踩过的坑

· 常用代码片段整理成模板

· 好的案例收藏起来备用

多实践多分享：

· 写博客巩固知识

· 参与开源项目

· 加入技术交流群

意外的收获

这6个月下来，收获远超预期：

技术层面：

· 从鸿蒙新手到能独立开发应用

· 掌握了完整的应用开发流程

· 积累了大量实战经验

个人成长：

· 项目管理能力提升

· 解决问题的思维更系统

· 学会了如何持续学习

社区影响力：

· 技术文章阅读10万+

· 认识了很多开发者朋友

· 应用被华为推荐博主推荐

· 获得2025年端云挑战赛第二名

· 入选1024程序员节推荐作品

10月份的时候，工具箱被华为推荐博主在B站推荐了（视频链接），还上了1024程序员节的公众号报道（文章链接），并且入选了1024程序员节推荐作品。那一刻真的特别开心，觉得这半年的努力都值了。

更让我惊喜的是，在2025年的端云挑战赛中，这个项目获得了第二名。说实话，参加比赛的时候根本没想过能拿奖，只是想检验一下自己的水平。当看到获奖名单的时候，真的特别激动，这半年的学习和努力得到了认可，那种成就感真的无法形容。

给新手的建议

如果你也想学习鸿蒙，我的建议是：

1、 不要怕，直接开始：不要等准备好了再学，边学边做效果更好

2、 做项目是最好的学习方式：找个实际需求，做个真实的应用

3、 多看官方文档：遇到问题先查文档，大部分都能找到答案

4、 加入社区很重要：认识同行，互相交流，进步更快

5、 坚持记录和分享：写博客、做笔记，帮助他人也是帮助自己

6、 云服务要早点学：现在的应用基本都要用到云服务，早学早受益

7、别怕踩坑：每个坑都是成长的机会，踩过的坑记得总结

特别建议：云服务学习路线

如果你的应用需要数据同步、用户系统，建议这样学习云服务：

第一步：了解基础概念（1-2天）

· 看官方文档，了解云数据库、云函数是什么

· 理解Serverless的概念

· 了解云服务的计费方式

第二步：跑通官方Demo（2-3天）

· 下载官方的云数据库Demo

· 下载官方的云函数Demo

· 本地跑起来，改改参数试试

第三步：集成到自己项目（1-2周）

· 先做简单的数据存储

· 再做数据查询

· 最后做数据同步

· 云函数从简单的HTTP触发开始

第四步：优化和完善（持续）

· 优化数据模型设计

· 添加错误处理

· 做好数据安全

· 优化性能

接下来的计划

学习永无止境，接下来我打算：

· 深入学习HarmonyOS NEXT的新特性

· 研究分布式能力的应用场景

· 继续参加各种技术比赛，提升自己

· 继续分享技术经验

鸿蒙生态还在快速发展，现在入场正是好时机。希望我的经历能给你一些启发和信心。

写在最后

从完全不懂鸿蒙，到现在能独立开发应用，这6个月真的是收获满满。

虽然过程中遇到很多困难，熬了很多夜，但每次解决问题后的成就感，每次看到用户反馈说好用，都让我觉得一切都值得。

学习技术最重要的，不是天赋，而是坚持和热爱。

如果你对鸿蒙开发感兴趣，欢迎一起交流学习。评论区见！

项目链接

· 鸿蒙开发者工具箱：华为应用市场

· 技术文章专栏：持续更新鸿蒙开发经验

愿每一位鸿蒙学习者，都能找到属于自己的星光之路！

—— 一个鸿蒙学习者的6个月成长记录（转载自CSDN，作者：在人间耕耘）