作者付文龙红目香薰仓库地址https://gitcode.com/feng8403000/FlutterfromBeginnertoAdvancedForHarmonyOS.git联系邮箱372699828qq.com一、函数在Dart中的核心地位函数是任何编程语言的基础构建块Dart也不例外。在Flutter开发中函数不仅用于封装可重用的代码逻辑更是构建UI组件、处理业务逻辑的核心手段。特别是在鸿蒙平台开发Flutter应用时良好的函数设计能够显著提升代码的可读性、可维护性和性能。1.1 为什么函数如此重要在Flutter应用开发中函数承担着以下几个关键角色代码复用将重复执行的逻辑封装为函数避免代码冗余逻辑封装将复杂逻辑分解为多个小函数便于理解和维护职责分离每个函数只负责单一职责符合单一职责原则测试便利独立的函数更容易进行单元测试回调机制在Flutter中函数常作为回调传递给Widget1.2 Dart函数的特点Dart作为一种现代编程语言其函数具有许多优秀特性特性说明示例一等公民函数可以作为参数传递、赋值给变量、作为返回值var func () print(Hello)可选参数支持可选位置参数和可选命名参数void greet(String name, [String? title])默认参数参数可以指定默认值void greet(String name, {String title 先生})箭头函数简化的单行函数语法(a, b) a b闭包支持函数可以捕获外部作用域的变量返回闭包函数二、基础函数定义2.1 函数声明语法在Dart中函数的基本语法如下返回类型 函数名(参数列表){// 函数体return返回值;}如果函数没有返回值可以使用void作为返回类型voidgreet(){print(Hello, HarmonyOS!);}2.2 带参数的函数函数可以接收参数参数需要指定类型voidgreetUser(Stringname){print(Hello,$name!);}intadd(int a,int b){returnab;}调用示例greetUser(付文龙);// 输出: Hello, 付文龙!int resultadd(3,5);// result 82.3 返回类型推断Dart支持返回类型推断但对于复杂函数建议显式指定返回类型以提高代码可读性// 可以推断返回类型为intmultiply(a,b)a*b;// 显式指定返回类型推荐intmultiply(int a,int b)a*b;三、参数类型详解3.1 可选位置参数可选位置参数使用方括号[]包裹可以在调用时省略Stringintroduce(Stringname,[int?age,String?occupation]){Stringresult我是$name;if(age!null){result今年$age岁;}if(occupation!null){result职业是$occupation;}returnresult;}调用方式print(introduce(付文龙));// 我是 付文龙print(introduce(付文龙,30));// 我是 付文龙今年 30 岁print(introduce(付文龙,30,高级软件工程师));// 我是 付文龙今年 30 岁职业是 高级软件工程师3.2 可选命名参数可选命名参数使用花括号{}包裹调用时需要指定参数名StringcreateUser({requiredStringname,required int age,String?gender,String?email,}){return用户:$name, 年龄:$age, 性别: ${gender ?? 未知}, 邮箱: ${email ?? 未设置};}调用方式print(createUser(name:付文龙,age:30));// 输出: 用户: 付文龙, 年龄: 30, 性别: 未知, 邮箱: 未设置print(createUser(name:付文龙,age:30,gender:男,email:372699828qq.com));// 输出: 用户: 付文龙, 年龄: 30, 性别: 男, 邮箱: 372699828qq.comrequired关键字用于标记必须传递的命名参数如果调用时缺少会导致编译错误。3.3 默认参数值参数可以设置默认值当调用时未传递该参数时使用默认值StringformatDate(int year,[int month1,int day1]){return$year-$month-$day;}StringbuildUrl(Stringpath,{Stringprotocolhttps,Stringhostapi.example.com}){return$protocol://$host/$path;}调用示例print(formatDate(2024));// 2024-1-1print(formatDate(2024,7));// 2024-7-1print(formatDate(2024,7,18));// 2024-7-18print(buildUrl(users));// https://api.example.com/usersprint(buildUrl(users,protocol:http,host:localhost:3000));// http://localhost:3000/users3.4 参数类型对比参数类型语法调用方式使用场景必填位置参数func(a, b)func(1, 2)必须传递的核心参数可选位置参数func(a, [b, c])func(1)或func(1, 2, 3)有顺序关系的可选参数可选命名参数func({a, b})func(a: 1, b: 2)参数较多或无明显顺序必填命名参数func({required a, b})func(a: 1)必须传递但使用命名更清晰四、箭头函数与匿名函数4.1 箭头函数箭头函数是Dart中简洁的函数写法适用于单行表达式intmultiply(int a,int b)a*b;boolisEven(int number)number%20;Stringcapitalize(Stringstr)str.isNotEmpty?str[0].toUpperCase()str.substring(1):str;使用示例print(5 * 6 ${multiply(5,6)});// 5 * 6 30print(4是否偶数:${isEven(4)});// 4是否偶数: trueprint(首字母大写: ${capitalize(flutter)});// 首字母大写: Flutter4.2 匿名函数匿名函数没有名称常用于作为参数传递Listintnumbers[1,2,3,4,5];// 使用匿名函数作为forEach的参数numbers.forEach((int number){print(数字:$number);});// 简化的匿名函数numbers.forEach((number)print(数字:$number));匿名函数也可以赋值给变量vargreet(Stringname)print(Hello,$name!);greet(付文龙);// Hello, 付文龙!五、函数作用域与闭包5.1 函数作用域Dart中的作用域分为全局作用域和函数作用域。函数内部定义的变量只能在函数内部访问voidexample(){int counter0;voidincrement(){counter;// 可以访问外部函数的变量}increment();print(counter);// 输出: 1}5.2 闭包闭包是指一个函数能够访问其词法作用域之外的变量即使该函数在其词法作用域之外执行FunctionmakeAdder(int addBy){return(int number)numberaddBy;}voidmain(){varadd5makeAdder(5);varadd10makeAdder(10);print(10 5 ${add5(10)});// 10 5 15print(10 10 ${add10(10)});// 10 10 20}在这个例子中makeAdder函数返回了一个闭包该闭包捕获了addBy变量。即使makeAdder函数已经执行完毕返回的闭包仍然能够访问addBy变量。六、实战格式化个人信息工具函数6.1 需求分析在个人信息卡片应用中我们需要实现以下功能将Person对象格式化为可读的文本支持完整格式和精简格式两种输出精简格式支持可选参数控制显示内容6.2 完整格式化函数staticStringformatPersonInfo(Personperson){StringBufferbufferStringBuffer();buffer.writeln(【个人信息卡片】);buffer.writeln(──────────────────);buffer.writeln(姓名:${person.name});buffer.writeln(年龄:${person.age}岁);buffer.writeln(性别:${person.gender});buffer.writeln(职业:${person.occupation});buffer.writeln(位置:${person.location});buffer.writeln(状态: ${person.isOnline ? 在线 : 离线});buffer.writeln(──────────────────);buffer.writeln(联系方式:);buffer.writeln( 邮箱:${person.email});buffer.writeln( 电话:${person.phone});buffer.writeln(──────────────────);buffer.writeln(社交账号: ${person.socialAccounts.join(,)});buffer.writeln(──────────────────);buffer.writeln(个人简介:${person.bio});returnbuffer.toString();}代码解析使用StringBuffer高效拼接字符串避免多次字符串拼接导致的性能问题使用模板字符串${}嵌入变量值使用三目运算符person.isOnline ? 在线 : 离线根据状态显示不同文本使用join(, )将社交账号列表转换为逗号分隔的字符串6.3 精简格式化函数staticStringformatPersonInfoCompact(Personperson,{bool showContactfalse,bool showSocialtrue,bool showBiofalse,}){StringBufferbufferStringBuffer();buffer.write(${person.name}(${person.age}));buffer.write( |${person.occupation});buffer.write( | ${person.isOnline ? 在线 : 离线});if(showContact){buffer.write( |${person.email});}if(showSocialperson.socialAccounts.isNotEmpty){buffer.write( | 社交:${person.socialAccounts.length}个);}if(showBio){buffer.write(\n简介:${person.bio});}returnbuffer.toString();}代码解析使用可选命名参数控制显示内容默认不显示联系方式和简介通过布尔参数showContact、showSocial、showBio控制各部分的显示使用isNotEmpty检查社交账号列表是否为空避免显示社交: 0个6.4 使用示例PersonpersonPerson(name:付文龙,age:30,occupation:高级软件工程师,gender:男,email:372699828qq.com,phone:13800138000,avatarUrl:,socialAccounts:[GitHub,CSDN,掘金,知乎],isOnline:true,location:北京市朝阳区,bio:热爱技术专注于Flutter跨平台开发,);// 完整格式StringformattedInfoformatPersonInfo(person);print(formattedInfo);// 精简格式显示联系方式不显示社交账号StringcompactInfoformatPersonInfoCompact(person,showContact:true,showSocial:false);print(compactInfo);输出结果【个人信息卡片】 ────────────────── 姓名: 付文龙 年龄: 30岁 性别: 男 职业: 高级软件工程师 位置: 北京市朝阳区 状态: 在线 ────────────────── 联系方式: 邮箱: 372699828qq.com 电话: 13800138000 ────────────────── 社交账号: GitHub, CSDN, 掘金, 知乎 ────────────────── 个人简介: 热爱技术专注于Flutter跨平台开发 付文龙(30) | 高级软件工程师 | 在线 | 372699828qq.com七、函数最佳实践7.1 单一职责原则每个函数应该只做一件事并且做得很好。如果函数太长或职责过多应该拆分为多个小函数。反例// 一个函数做了太多事情voidprocessUserData(MapString,dynamicuserData){// 验证数据// 转换格式// 保存到数据库// 发送通知}正例boolvalidateUserData(MapString,dynamicuserData){// 验证数据returntrue;}UserconvertUserData(MapString,dynamicuserData){// 转换格式returnUser();}voidsaveUser(Useruser){// 保存到数据库}voidsendNotification(Useruser){// 发送通知}7.2 函数命名规范函数名称应该清晰描述其功能使用动词开头好的命名formatPersonInfo、calculateTotal、validateEmail不好的命名doSomething、processData、handleStuff7.3 参数数量控制函数参数不宜过多一般建议不超过4个。如果参数太多考虑使用对象封装// 不好的做法voidcreateUser(Stringname,int age,Stringemail,Stringphone,Stringaddress){// ...}// 好的做法voidcreateUser(Useruser){// ...}7.4 返回类型明确对于公共API应该显式指定返回类型。对于简单的私有函数可以使用类型推断。// 公共API - 显式指定返回类型StringformatName(StringfirstName,StringlastName){return$firstName$lastName;}// 私有函数 - 可以使用类型推断_add(int a,int b)ab;7.5 使用StringBuffer拼接大量字符串当需要拼接大量字符串时应该使用StringBuffer而不是直接使用运算符// 低效的方式StringbuildString(){Stringresult;for(int i0;i1000;i){resultitem$i\n;// 每次都会创建新字符串}returnresult;}// 高效的方式StringbuildString(){StringBufferbufferStringBuffer();for(int i0;i1000;i){buffer.writeln(item$i);// 直接追加到缓冲区}returnbuffer.toString();}八、在鸿蒙平台的特殊考虑8.1 平台特定代码调用在鸿蒙平台上有时需要调用原生代码。这时候需要定义平台通道函数staticFutureStringgetHarmonyOSVersion()async{constplatformMethodChannel(com.example/harmonyos);try{finalStringversionawaitplatform.invokeMethod(getVersion);returnversion;}onPlatformExceptioncatch(e){return获取版本失败:${e.message};}}8.2 异步函数与鸿蒙平台鸿蒙平台对异步操作有特殊要求需要确保函数正确处理异步调用FuturevoidloadUserData()async{try{// 模拟网络请求awaitFuture.delayed(constDuration(milliseconds:500));// 更新UI状态setState((){_userData_fetchMockData();});}catch(e){// 在鸿蒙平台上错误处理尤为重要_showErrorDialog(加载数据失败);}}8.3 性能优化在鸿蒙平台上函数调用的性能需要特别关注避免在build方法中创建函数使用const构造函数减少对象创建对于频繁调用的函数考虑使用静态函数或内联九、总结函数是Dart语言的核心特性掌握函数定义和参数使用是Flutter开发的基础。在本文中我们学习了基础函数定义包括函数声明、参数、返回值参数类型可选位置参数、可选命名参数、默认参数值箭头函数与匿名函数简化的函数写法函数作用域与闭包理解变量作用域和闭包的应用实战示例格式化个人信息的工具函数最佳实践函数设计的原则和规范鸿蒙平台特殊考虑平台特定代码和性能优化通过合理使用函数我们可以编写出更加清晰、可维护、高效的Flutter代码为鸿蒙平台上的应用开发打下坚实的基础。附录完整示例代码完整的示例代码位于 [004_function_definitions.dart](file:///d:/Flutter/flutter_harmonyos_study/lib/examples/chapter_01/section_1_1/004_function_definitions.dart)包含了所有示例和实战代码。