ArkTS 是 HarmonyOS 的主力开发语言，它在 TypeScript 的基础上增加了大量编译期约束规则。这些规则在提升代码安全性的同时，也让不少开发者频频"踩坑"。本文基于一个真实的儿童练字板项目开发经历，整理了7 类高频编译错误的完整报错信息、根因分析和修复方案，并在最后总结出日常开发注意事项清单，适合作为 ArkTS 开发的速查手册。页面类型是否需要 @Entry是否注册 main_

是 HarmonyOS Canvas 组件的核心绑定上下文，提供了丰富的 2D 绘图 API。它就像一支"万能画笔"，能够绘制图形、文本、图像，还支持渐变、阴影、变换等高级效果。本文将从基础到高级，系统讲解的全部使用方法，并配合实战示例帮助读者快速上手。是 HarmonyOS 2D 绘图的核心 API。基础绑定：矩形、路径、圆弧、贝塞尔曲线的绘制文本绘制：字体设置、对齐方式、度量高级效果：渐变、阴

在 HarmonyOS 应用开发中，Canvas（画布）是最核心的 2D 绘图组件。无论是儿童练字板、签名板、涂鸦应用，还是数据可视化图表，都离不开 Canvas 的身影。本文将系统讲解 Canvas 组件的使用方法，并通过一个完整的实战示例，带你从零基础到熟练运用 Canvas 进行绘图开发。Canvas 是 ArkUI 框架提供的自定义绘制组件，开发者可以通过上下文对象，在画布上绘制各种图形、

在 HarmonyOS 应用开发中，Canvas（画布）是最核心的 2D 绘图组件。无论是儿童练字板、签名板、涂鸦应用，还是数据可视化图表，都离不开 Canvas 的身影。本文将系统讲解 Canvas 组件的使用方法，并通过一个完整的实战示例，带你从零基础到熟练运用 Canvas 进行绘图开发。Canvas 是 ArkUI 框架提供的自定义绘制组件，开发者可以通过上下文对象，在画布上绘制各种图形、

订单模块是蛋糕美食元服务的核心业务闭环模块，包含**订单确认（PageOrderPreview）订单历史（OrderList）**两个子功能。该模块实现了从购物车到下单、从订单创建到历史查看的完整订单生命周期管理。

地图模块（PageShopList）实现门店浏览和选择功能，为用户提供一个直观的门店列表，支持地图展示区域折叠、门店卡片展示、门店选择和确认等操作。该模块在点餐流程中起到"选择取餐/配送门店"的关键作用。

ArkTS：V2（@ComponentV2系列装饰器）本篇详细讲解个人中心模块的实现。作为应用最后一个 Tab 页，个人中心是——包含 3 个组件/页面、404 行源码，涵盖用户头像展示、功能网格、登录验证码倒计时、评论列表、退出登录、等核心功能。

首页模块（Home）是蛋糕美食元服务的门面模块，承担品牌展示和快捷导航的核心职责。用户打开应用后首先看到的就是首页，它需要快速传递品牌调性并提供清晰的功能入口。

项目基于 HarmonyOS 6.1（API 23），全面采用 State Management V2。在渲染阶段做视觉位移，不参与布局计算，父容器不感知子元素位置变化，动画效果也依赖子元素自身携带。是布局阶段属性，直接决定子元素的排列起点，改变时布局重新计算，容器上的。回调，需在支持该能力的 HarmonyOS 真机上验证。字段变化会自动穿透刷新所有依赖该字段的子组件，无需额外。改变时才重渲染，

美食模块（Food）是整个蛋糕美食元服务中最核心、最复杂的业务模块。它实现了完整的功能，采用双栏布局设计，左侧为分类导航，右侧为商品列表，底部为悬浮购物车栏。