这张路线适合谁

前置知识一句话说死：会任意一门主流语言（变量、函数、类、异步的概念清楚），会用命令行装东西，就能上路。ArkTS 是 TypeScript 的强约束方言，写过 TS 的人前半程几乎是复习；没写过也没关系，站内《ArkTS 语法要点》就是为此准备的。完全零编程基础的话，先过一遍任何一门语言的入门课再来，这条路线救不了零基础。时长口径：每天 1-2 小时业余学习，五个阶段合计 6-9 周。已经在写 React Native、Kotlin 或 Flutter 的读者，直接拉到下面的对照节，你有捷径。

总览

这条路线的骨架就是本站鸿蒙系列的六篇（本文是第六篇），阶段产出全部是”做出一个小东西”，不是”看完了什么”。

阶段一：工具链（2-3 天）

学什么：DevEco Studio 的安装与 SDK 管理、模拟器与真机调试、签名与运行配置、hvigor 构建链的基本概念。资源就一篇：《鸿蒙环境搭建与工具链》，照着做一遍；外部资源不需要，这个阶段的价值在动手。产出与验收：模拟器和真机各跑起一次模板应用。常见卡点两个：模拟器镜像下载慢（换官方提供的国内源）；真机调试要开开发者模式并在弹窗里授权，数据线质量差会导致设备反复掉线，换线比换驱动先试。

阶段二：语言与第一个应用（2-3 周）

整条路线最重的阶段，慢就是快。两组概念按顺序过：先 ArkTS 语言面（类型与空安全、对象字面量受的约束、异步 async/await），再声明式 UI 面（@Entry/@Component/build 三件套、@State 一改界面就变）。资源两篇：《第一个鸿蒙应用》走完最小闭环，《ArkTS 语法要点》当随用随查的字典。产出与验收：把模板计数器改造成两个页面的雏形（首页列表 + 详情页），能传参跳转。常见卡点两个：UI 不刷新——多半改的是普通变量而不是 @State 标注的变量，或改的是数据副本；对象字面量报错——ArkTS 禁止不带类型的字面量与 any，这是从 TS 迁移最大的一道坎，语法要点篇有整节解释。

阶段三：查阅能力（与阶段二并行）

学什么：不是读教程，是建立”遇到问题先查哪”的索引。资源：《ArkTS 参考字典》，按”场景 → API → 坑”组织，配合华为官方文档中心用。产出与验收：自己的踩坑笔记十条，格式照字典来。错误信息原文、原因、解法各一行——这份按你的错误史排序的笔记，走完全程后价值超过任何教程。

阶段四：布局与导航（1 周）

学什么：三大布局容器与 Flex 的分工、列表懒加载、滚动嵌套、Navigation 导航体系、断点与安全区适配。资源一篇：《ArkUI 布局与导航》。产出与验收：一个多页面应用——首页列表可滚动、点项进详情、返回不丢状态，手机与折叠屏（或模拟器改窗口宽度）各看一遍不穿帮。常见卡点：Navigation 的目的地页忘记以 NavDestination 为根，页面空白但无报错；列表不懒加载是因为没约束高度，LazyForEach 挂在了被撑开的容器里。

阶段五：实战（1-2 周）

学什么：把语法变成架构决策——本地持久化怎么选（RelationalStore 还是 preferences）、状态管理 V1 还是 V2、列表性能什么时候需要优化。资源：《用 ArkTS 做一个记账小工具》，跟着做完后必须脱离文章做一个变体（读书清单、打卡器），否则决策链还是作者的不是你的。产出与验收：一个自己日常真在用的本地工具，验收照实战篇的表逐条过——杀进程不丢数据、飞行模式可用、千条数据滚动流畅，每条都带怎么测。

生态现实：市场与岗位，如实说

学之前值得把生态账算清。市场面：据 Counterpoint 数据，鸿蒙在中国智能手机系统份额于 2024 年一季度首次超过 iOS（约 17%），此后季度保持领先、稳定在 15% 以上，全球份额约 4%（几乎全部来自中国市场）。生态面：HDC 2024（2024-06）公布的口径是鸿蒙生态设备数超 9 亿、HarmonyOS 开发者 254 万，TOP 5000 常用应用已全部启动鸿蒙原生开发——应用厂商的迁移需求就是岗位的直接来源；招聘要求集中在 ArkTS/ArkUI 与 HarmonyOS 认证证书——认证有基础与高级两档，备考过程本身是不错的知识梳理，但别指望一张证替代项目经历，面试官两个都看。这些数字不同来源口径差异不小（培训机构转引的缺口、薪资数字建议打折看），但方向一致：国内（尤其设备厂、银行与政务类外包）需求真实存在，且集中在有硬件业务的城市。给你的定位建议：把它当”国内求职的差异化加分项”或”公司要上鸿蒙时的先手”，价值明确；赌它替代 Android/iOS 全部岗位则不现实——存量岗位里 Android 仍是移动端大头。

与 React Native、Kotlin、Flutter 路线的对照

四条路线站内都有成线的内容：React Native 学习路线、Kotlin/Compose 学习路线、Flutter 学习路线。顺带一个常见问题的实话：已有 Flutter 代码想上鸿蒙，官方主线并无鸿蒙后端，OpenHarmony-SIG 维护着适配仓库（适配进度通常落后上游稳定版一截），插件适配面要自己评估——这正说明原生 ArkTS 技能有它的不可替代性。

避坑清单

• 不要拿 Android 心智硬套。没有 Activity、没有 AndroidManifest，Stage 模型的 UIAbility 与 AbilityContext 是另一套世界观，套着写处处别扭。代价：每个概念都”半懂”，排错时方向全错。
• 不要把 ArkTS 当纯 TS 写。any、无类型对象字面量、解构滥用都会被编译器拦下。这不是缺陷，是换性能与规范买单，先接受规则再谈效率。
• 不要跳过声明式心智直接抄界面。build 里写 if/else 条件渲染与在命令式框架里改 DOM 是两回事，心智没立住，@State 不刷新的问题能卡你一晚上。
• 不要在版本上无脑追新。HarmonyOS NEXT 5.0（API 12）已是当前商用版本，但存量华为设备停留在旧版本系统的不在少数，工程里最低兼容版本按目标用户设备定，别默认全员新机。
• 不要只看不产出。每个阶段的”做出一个小东西”才是验收，收藏夹里再多教程也变不成能力。

学完之后

这条线的终点是一个你能日用且不丢数据的本地工具，以及独立走完”选型对比 → 实现 → 验收”的完整决策经验。往后的分岔按兴趣走：多设备协同（分布式软总线一族）、元服务与卡片、或是把本地工具接上后端。求职向的读者，把系列项目整理成两三个能开口讲清选型理由的 demo，比简历上多写三个名词有用。移动端横向扩展的话，对照节里三条路线都在站内；想接 AI 能力（端侧调用大模型 API、RAG 类应用）则另有一片内容可挖。版本核实（2025-01）：路线涉及的版本事实——HarmonyOS NEXT 5.0（API 12，2024-10-22 正式发布）为当前商用版本、状态管理 V2 自 API 12 起提供、Counterpoint 2024 各季度份额与 HDC 2024 生态数据（设备 9 亿+、开发者 254 万）为公开报道口径——撰写时均已核对；工具与 API 细节以华为官方文档为准。