ArkTS是TypeScript的超集，删减动态特性、强化声明式UI与状态管理，禁用any、var及动态属性访问，要求显式类型标注、@Component/@State装饰器及interface定义接口。
想在HarmonyOS生态中真正动手开发应用，必须先掌握ArkTS语言基础语法——它不是另起炉灶的新语言，而是TypeScript的超集，但删减了动态特性、强化了声明式UI和状态管理能力，直接写错类型或滥用any会编译失败，根本跑不起来。
从TypeScript平滑过渡到ArkTS
如果你写过React+TypeScript项目，打开DevEco Studio新建一个Empty Ability模板，src/main/ets/pages/Index.ets文件里第一行就是@Entry装饰器，这说明你已站在ArkTS起点上——所有合法TS代码都能在ArkTS中运行，但反过来不成立。
第一步：删掉项目里所有any类型声明。ArkTS明确禁用any，比如let data: any = {}会报错，必须改为let data: Record<string unknown=""></string>,>或具体接口类型。
第二步：把JSX中习惯写的obj[key]动态属性访问全部替换成点语法或明确键名，例如user.name✅，user[role]❌——ArkTS编译器无法静态分析动态key，直接拒绝编译。
第三步：检查所有console.log调用，确保参数类型可推断。ArkTS对日志函数参数做轻量校验，传入undefined或null可能触发警告，虽不中断编译但会影响调试体验。
变量与函数：只保留最安全的写法
方法一：用const声明不可变数据，用let声明需重赋值的变量，禁止使用var——ArkTS已完全移除var支持，写了就报语法错误。
方法二：函数必须标注返回类型，哪怕看起来很简单。比如function add(a, b) { return a + b }会报错，要写成function add(a: number, b: number): number { return a + b }。
方法三：箭头函数参数类型不能省略。这个容易忽略：const handleClick = (e) => {...}不行，必须写const handleClick = (e: MouseEvent) => {...}，【MouseEvent是@ohos.arkui.ability提供的标准事件类型，不是浏览器DOM类型】。
类与装饰器：HarmonyOS特有的核心语法
第一步：在类顶部必须加@Component装饰器才能被识别为UI组件，否则build()方法不会生效，页面空白也不报错——这是新手最常踩的坑。
第二步：状态变量必须用@State修饰，比如@State count: number = 0。如果漏掉@State，变量修改后UI绝不会刷新，debugger看到值变了但界面上纹丝不动。
第三步：构造函数里禁止调用this.xxx()方法。ArkTS要求构造函数只做初始化赋值，方法调用必须放在aboutToAppear生命周期钩子中——否则编译通过但运行时崩溃。
第四步：接口定义必须用interface，不能用type声明复杂结构。ArkTS对type的支持有限，尤其涉及泛型嵌套时，interface更稳定可靠。
快速验证语法是否正确
在DevEco Studio中右键点击ets文件 → “Run” → 选择模拟器或真机。只要出现红色波浪线或底部终端显示“Build failed”，立刻停手——ArkTS的编译错误非常明确，通常带行号和建议修复方案，照着改就行。
把官方示例代码复制进Index.ets，删掉一行再保存，观察实时报错提示。这个过程比读文档更快建立语感。
打开“Help → HarmonyOS Documentation”，搜索“ArkTS grammar rules”，点开最新API 12文档页，左侧导航栏展开“Language Basics”，里面每个语法条目都带可运行的最小代码块，直接复制粘贴就能验证。
