尚硅谷 HarmonyOS 应用开发——源码与课件版

这套资料的主题很明确：用 HarmonyOS 的 ArkTS 技术栈做完整应用开发。和常见的纯视频教程不同，它同时提供了可运行的工程源码、配套笔记和素材资源，适合边看边改、边跑边对照。下面从技术栈、工程结构、可复用代码和自学路径几个角度拆开讲，方便你判断该以什么姿势使用它。

技术栈：ArkTS + ArkUI 的声明式路线

HarmonyOS 应用开发当前主推的是 ArkTS，它以 TypeScript 为语法基础，配合 ArkUI 的声明式 UI 框架。这套资料在语言层面把 TS 的类型系统、接口、泛型、装饰器等概念讲透，再落到 ArkTS 的 @Component、@Entry、@State、@Prop、@Link、@Builder 等装饰器语义上。这一点很关键——很多人写 HarmonyOS 卡壳，不是不会写界面，而是没弄清状态装饰器的数据流向：@State 管组件内部状态，@Prop 做单向传递，@Link 做双向绑定，@Provide/@Consume 跨层级通信。资料把这类语义放在了具体组件里演示，而不是孤立地讲语法。

UI 部分覆盖 ArkUI 的常用组件（Text、Button、Image、List、Grid、Tabs 等）与布局容器（Row、Column、Flex、Stack、RelativeContainer）。布局是 ArkUI 里最容易写乱的地方，因为约束方式和 Web 的 CSS 不完全一样。跟着源码里的页面结构走一遍，能较快建立“容器嵌套 → 尺寸约束 → 对齐方式”的直觉。

项目结构：从工程骨架理解模块划分

拿到源码后，建议先不要急着看业务代码，而是把工程骨架读一遍。HarmonyOS 工程采用 Stage 模型，entry 模块承载主 HAP，每个 Ability 有独立的生命周期；module.json5 负责声明权限、Ability 入口和路由信息，app.json5 描述应用级配置。resources 目录按 base、限定词目录组织字符串、颜色、媒体资源，这种多限定的资源组织方式和 Android 的思路相近，但文件名与引用语法有差异。

把这些配置文件看明白，后续改主题色、加权限、配路由时就不用到处翻文档。资料里的笔记对这部分有对应的说明，源码则给出了真实的目录层级，两边对照着看效率最高。

可复用模块：网络请求与状态管理

几块内容值得单独抽出来复用。一是网络请求的封装：通常会把 HTTP 请求包成统一的工具类，处理 baseURL、请求头、超时、错误码和返回数据的泛型解析，业务层只关心接口名和参数。二是数据模型与接口返回的结构映射，用 TS 的 interface 定义实体，减少 any 的滥用。三是页面级的状态组织，把 UI 状态和业务数据分开，避免所有变量都堆在 @State 里。

四是路由与页面跳转的集中管理，用 router 或 Navigation 统一处理参数传递和返回结果。五是公共组件的抽取，比如列表项、空状态、加载提示这类高频 UI，抽成自定义组件后能明显减少重复代码。这些模块在源码里都有对应实现，可以直接移植到自己的工程中，注意替换掉资源和接口地址。

自学路径：以跑通和改造为主线

比较务实的顺序是：先照着笔记把开发环境跑起来，确认能编译、能上模拟器或真机预览；然后从最简单的单页面入手，理解一个 @Entry 组件从创建到渲染的完整链路；接着进入列表与网络请求，这是绝大多数应用的骨架；最后做页面跳转和多页面状态共享。每完成一个阶段，就动手改一处——换布局、换数据源、加一个交互，改到出问题再回源码对照。

视频在这里的作用是解释思路和排错，而不是替代动手。源码和笔记才是这套资料的核心价值，因为它们允许你停下来、改一行、看结果。

适合谁，不适合谁

如果你已经具备基本的编程经验，尤其是接触过 TypeScript 或其他声明式 UI 框架，这套资料能帮你较快地把概念映射到 HarmonyOS 的具体 API 上。如果你完全没有编程基础，建议先补 TS 基础再来。需要提醒的是，HarmonyOS 的 API 版本迭代较快，源码中的某些写法可能与当前 SDK 有差异，遇到编译报错时优先查官方文档的版本说明，而不是硬套旧代码。把它当作一份可运行的参考实现，而不是需要逐字背诵的教材，收获会更实在。