SuperAPI AI 工具集

kotlin-best-practices

写作与研究

查看项目

更新于 10-15 22:13

技能介绍

用途:该技能提供编写健壮、地道 Kotlin 代码的核心模式与实现指南,优先级标注为 P1(HIGH),适合在编写 Kotlin 代码、选择作用域函数或封装可变状态时使用。

主要能力: 作用域函数选择:apply 用于对象配置并返回对象;also 用于副作用、校验或日志并返回对象;let 用于空检查(?.let)或映射并返回结果;run 用于对象配置与映射并返回结果;with 用于对同一对象分组调用多个方法并返回结果。 Backing Properties:使用 _state 作为私有可变属性(如 private val _state = MutableStateFlow(initial)),对外暴露为 val state = _state.asStateFlow() 的公开只读形式,模式为 _prop 私有、prop 公开。 集合:对外暴露 List/Map 等只读类型,MutableList 保持内部可见。 错误处理:简单场景优先使用 runCatching 而非 try/catch 块。 可见性:默认使用 private 或 internal,尽量缩小公开接口面积。 顶层声明:优先使用顶层函数与常量,而非无实现的 object 单例。

反模式:避免深层作用域嵌套,let/apply 嵌套不超过 2 层,更深会损害可读性;避免公开 var,应使用 private set 或 backing properties 实现封装;避免全局可变状态,不使用可变的顶层变量。

使用方式与限制:资料未提供具体安装命令、调用步骤或平台信息,暂未提供。该技能以规范与示例参考为主,需结合具体项目与 Kotlin 版本自行应用。