鸿蒙ArkTS核心编程手册：函数参数、高阶封装、异步Promise/async-await、流程控制与异常捕获规范

一、前言告别JS/TS陋习建立ArkTS工程化编程思维在鸿蒙开发中绝大多数闪退、接口报错、逻辑异常、内存隐患都源于函数不规范、异步写法混乱、异常不捕获、流程控制随意。很多前端开发者沿用松散的JS/TS写法参数不定义、异步嵌套地狱、异常裸奔、循环逻辑不严谨在静态强类型的ArkTS体系下极易出现编译报错、隐性Bug、页面渲染异常等问题。本文一站式吃透ArkTS完整函数体系、默认参数/剩余参数、高阶函数封装、条件循环流程控制、Promise/asyncawait异步全机制、try/catch工程化异常捕获规范所有代码均为鸿蒙原生可直接运行的标准写法适配项目开发、组件封装、网络请求、业务逻辑落地。二、ArkTS函数完整体系强类型规范ArkTS摒弃JS动态弱类型特性强制函数参数、返回值类型可控杜绝隐式类型转换、空值逃逸是业务逻辑稳定的核心基础。1. 基础函数定义规范ArkTS工程强制规范简单函数可类型推导业务函数必须显式声明参数与返回值类型无返回值统一使用void。// 标准规范带参数类型 返回值类型 function add(a: number, b: number): number { return a b; } // 无返回值函数 function printLog(msg: string): void { console.log(日志, msg); } // 空参函数 function getAppVersion(): string { return 1.0.0; }2. 可选参数通过?定义可选参数可选参数必须放在必选参数后方适配参数非必传业务场景。// age 为可选参数 function getUserInfo(name: string, age?: number): string { if (age) { return 姓名${name}年龄${age}; } return 姓名${name}年龄未知; } // 调用支持两种传参方式 getUserInfo(鸿蒙开发者); getUserInfo(鸿蒙开发者, 25);3. 默认参数工程高频默认参数可替代大量空值判断逻辑参数未传参/传undefined时自动生效简化容错代码提升代码简洁度。// 带默认参数分页默认第1页、每页10条 function getPageList(page: number 1, size: number 10): void { console.log(请求页码, page, 条数, size); } getPageList(); // 默认 1、10 getPageList(2); // 2、10 getPageList(3, 20); // 3、20规范要点默认参数优先级高于可选参数无需额外写undefined兜底。4. 剩余参数 Rest不定长参数ArkTS 严格约束剩余参数规则仅能作为函数最后一个参数、类型必须为数组用于接收不定数量的同类型参数适配批量计算、批量传参场景。// 不定长数字求和 function sum(...numbers: number[]): number { let total 0; for (let n of numbers) { total n; } return total; } console.log(sum()); // 0 console.log(sum(1, 2, 3)); // 6 console.log(sum(10, 20)); // 30核心禁忌剩余参数后禁止拼接其他参数禁止混合不同类型数据。三、高阶函数封装实战ArkTS工程化核心高阶函数指参数为函数、返回值为函数的函数是鸿蒙工具封装、接口拦截、防抖节流、通用逻辑抽离的核心能力配合泛型可实现绝对类型安全。1. 基础高阶函数函数作为参数// 通用数组遍历高阶函数 function arrForEachT(arr: T[], callback: (item: T, index: number) void): void { for (let i 0; i arr.length; i) { callback(arr[i], i); } } // 调用 let strArr: string[] [鸿蒙, ArkTS, HarmonyOS]; arrForEach(strArr, (item, index) { console.log(index, item); });2. 高阶函数返回函数防抖实战业务高频场景搜索框输入、按钮防重复点击通过高阶函数封装通用防抖逻辑全局复用。// 通用防抖封装 function debounce(fn: () void, delay: number) { let timer: number | null null; return function() { if (timer) clearTimeout(timer); timer setTimeout(() { fn(); }, delay); } } // 业务使用 const search debounce(() { console.log(执行搜索请求); }, 500);四、条件与循环流程控制ArkTS严格规范ArkTS 延续标准流程控制语法但强类型校验严格语法约束杜绝JS隐式转换漏洞适配业务判断、数据遍历场景。1. 条件判断 if / else if / else禁止隐式布尔转换判断条件必须精准空值、零值、空字符串需显式判断。let score: number 85; if (score 90) { console.log(优秀); } else if (score 60) { console.log(及格); } else { console.log(不及格); }2. 多分支 switch 规范适配枚举、固定状态判断必须写break防止穿透复杂状态优先使用switch而非多层if。enum OrderStatus { PENDING, PAYED, FINISH, CANCEL } let status: OrderStatus OrderStatus.PENDING; switch (status) { case OrderStatus.PENDING: console.log(待支付); break; case OrderStatus.PAYED: console.log(已支付); break; case OrderStatus.FINISH: console.log(已完成); break; case OrderStatus.CANCEL: console.log(已取消); break; default: console.log(未知状态); }3. 三大循环规范for 循环精准下标遍历适配复杂逻辑for (let i 0; i 5; i) { console.log(下标, i); }for...of 循环遍历数组/字符串工程首选let list: string[] [A, B, C]; for (let item of list) { console.log(元素, item); }while / do...while 循环条件循环let num: number 0; while (num 3) { console.log(num); num; }五、ArkTS异步编程全解Promise完整机制鸿蒙网络请求、本地存储、动画延时、线程任务均为异步操作Promise是异步编程的底层核心彻底解决回调地狱问题是async/await的基础。1. Promise三种状态不可逆pending进行中初始状态fulfilled成功完成触发thenrejected失败异常触发catch状态一旦从pending变更为成功/失败永久不可逆。2. Promise基础封装模拟接口请求// 封装通用异步请求 function requestData(): Promisestring { return new Promise((resolve, reject) { // 模拟网络延时 setTimeout(() { let isSuccess true; if (isSuccess) { resolve(接口请求成功返回数据); } else { reject(new Error(接口请求失败)); } }, 1000); }); } // 链式调用 requestData().then(res { console.log(res); }).catch(err { console.log(err.message); }).finally(() { console.log(请求结束无论成败都会执行); });3. Promise常用静态方法// 1. Promise.all所有请求成功才返回任意一个失败直接失败 Promise.all([requestData(), requestData()]) // 2. Promise.race谁先完成返回谁 Promise.race([requestData(), requestData()]) // 3. Promise.resolve / reject快速创建Promise Promise.resolve(成功数据); Promise.reject(new Error(自定义异常));六、async/await 终极异步方案鸿蒙工程首选async/await是Promise的语法糖将异步代码转为同步写法代码可读性极强是鸿蒙项目网络请求、异步业务的统一规范写法。1. 核心语法规则函数前加async标识异步函数返回值自动包装为Promiseawait只能在async函数内部使用await会阻塞当前异步流程等待Promise状态变更后继续执行2. 标准实战写法// 异步函数 async function loadData() { try { // 等待异步请求完成 let res await requestData(); console.log(拿到异步结果, res); } catch (err) { console.log(异步请求异常, err); } } // 调用异步函数 loadData();3. 连续异步串行请求业务高频// 先请求用户信息再请求用户列表 async function loadUserPage() { try { await requestData(); await requestData(); console.log(所有请求执行完毕); } catch (err) { console.log(请求异常); } }七、ArkTS try/catch 异常捕获工程规范杜绝闪退ArkTS作为编译型强类型语言编译期可拦截大部分错误但运行时异常、异步异常、接口数据异常、类型转换异常必须通过try/catch捕获否则会导致页面白屏、应用闪退、未捕获异常报错。1. 基础语法结构try { // 可能报错的风险代码 let str: string null as unknown as string; str.length; } catch (err) { // 捕获异常兜底容错 console.log(捕获运行时异常, err); } finally { // 无论是否报错必然执行释放资源、关闭加载弹窗 console.log(执行收尾操作); }2. 四大必须加try/catch的业务场景所有await异步请求网络超时、接口报错、数据为空必捕获数据解析、类型转换JSON解析、强类型断言容错本地存储、文件读写权限不足、文件不存在异常复杂计算、递归逻辑数值溢出、死循环报错兜底3. 异步异常核心规范重点避坑ArkTS中裸奔的async函数异常不会崩溃进程但会产生unhandledRejection 未捕获异常造成隐性业务异常所有await必须包裹try/catch。// 工程标准异步模板 async function safeRequest() { try { let res await requestData(); // 正常业务逻辑 } catch (error) { // 统一异常处理弹窗提示、日志上报、容错兜底 console.error(异步业务异常, error); } }八、高频踩坑与工程落地规范总结1. 函数参数规范默认参数、可选参数后置剩余参数必须为最后一个参数禁止无类型函数业务函数必须显式声明参数、返回值类型不定长参数统一使用剩余参数摒弃arguments动态取值2. 高阶函数规范通用工具高阶函数必须搭配泛型保证类型安全防抖、节流、遍历封装统一抽离全局工具避免代码冗余3. 异步编程规范杜绝Promise嵌套地狱优先使用async/await同步化写法所有异步请求强制try/catch捕获禁止异常裸奔并发场景优先使用Promise.all提升请求效率4. 流程与异常规范switch语句必须写break防止状态穿透循环内部避免频繁创建函数、对象优化内存性能finally仅用于资源释放禁止写业务逻辑、修改返回值