一、引入：为什么需要ArkTS？
ArkTS是HarmonyOS应用开发的主力语言，它基于TypeScript（TS）生态扩展，不仅保留了TS的静态类型检查等特性，还针对鸿蒙的声明式UI和状态管理进行了强化。对于初学者，掌握ArkTS是构建高性能、可维护鸿蒙应用的关键第一步 。
二、讲解：ArkTS核心语法精讲
1. 基础语法：变量、函数与类型系统
变量与常量：使用let声明变量，const声明常量，支持类型注解与类型推断 。
let count: number = 10; // 显式类型注解
const appName = "MyApp"; // 类型推断为string
函数定义：支持常规函数、箭头函数、可选参数和默认参数 。
// 常规函数
function add(x: number, y: number): number {return x + y;
}
// 箭头函数（简化回调）
const multiply = (a: number, b: number) => a * b;
联合类型：增强类型灵活性，允许变量为多种类型之一 。
let value: string | number; // 可存储字符串或数字
value = "Hello";
value = 100;
2. 自定义组件与装饰器
组件结构：通过@Component装饰的struct定义可复用UI单元，build()方法描述UI结构 。
@Component
struct WelcomePage {@State message: string = "Hello ArkTS"; // 状态变量build() {Column() {Text(this.message).fontSize(20).onClick(() => {this.message = "点击更新！"; // 状态驱动UI刷新})}}
}
- 装饰器作用：
@State：组件内状态，变化时自动触发UI更新 。@Entry：标记页面入口组件，每个页面有且仅有一个 。
3. 声明式UI描述
链式调用：属性与事件方法通过链式调用配置，代码更简洁 。
Button("提交").width(100).height(40).backgroundColor(Color.Blue).onClick(() => {console.log("按钮被点击");})
条件与循环渲染：通过if和ForEach动态控制UI显示 。
Column() {if (this.isLogin) {Text("欢迎回来！") // 条件渲染} ForEach(this.items, (item) => {Text(item.name) // 循环渲染列表})
}
4. 模块化开发
导出与导入：使用export暴露组件或函数，import引入依赖 。
// 在utils.ets中定义并导出
export function logDebug(msg: string) {console.log(msg);
}
// 在页面中导入使用
import { logDebug } from '../utils/utils';
三、总结与常见问题
✅ 核心要点
- 类型安全：ArkTS的强类型系统减少运行时错误，提升代码可靠性 。
- 声明式范式：通过状态驱动UI更新，避免手动操作DOM 。
- 组件化思维：将界面拆分为可复用的自定义组件，提高可维护性 。
⚠️ 避坑指南
- 避免
any类型：尽量明确变量类型，而非滥用any，以发挥静态检查优势 。 - 组件命名规范：自定义组件名不能与系统组件（如
Text、Button）重复 。 - 事件绑定
this指向：使用箭头函数或bind确保事件回调中this指向正确 。
下一步预告：在第三篇中，我们将深入ArkUI声明式布局，学习如何用
Column、Row等容器组件构建复杂界面。