Kotlin开发规范

这个技能能帮你做什么

Kotlin 是一门简洁而强大的语言，但用得不好也会写出冗长或不安全的代码。这个技能提供了一套经过验证的 Kotlin 开发模式，让你的代码既符合语言习惯，又安全高效。

简单说，它能帮你：

• 避免空指针 —— 利用 Kotlin 的类型系统，在编译期就发现潜在的空值问题
• 写出简洁代码 —— 用更少的代码表达同样的意思，提升可读性
• 安全处理并发 —— 使用协程和 Flow 处理异步操作，避免回调地狱
• 组织数据模型 —— 用数据类、密封类等特性设计清晰的数据结构
• 扩展能力 —— 在不修改原有代码的情况下，为现有类型添加新功能

什么时候用

写新功能时 —— 不确定某个场景用 Kotlin 的哪种特性最合适

审查代码时 —— 检查代码是否符合 Kotlin 惯用写法

从 Java 迁移时 —— 把 Java 代码重写成更地道的 Kotlin

处理异步逻辑时 —— 网络请求、数据库操作等异步场景

设计数据结构时 —— 需要表达复杂的数据关系和状态

主要覆盖哪些场景

1. 空安全
   • 区分可空和不可空类型，让空值在编译期就被发现
   • 安全调用（?.）和 Elvis 运算符（?:）处理可能的空值
   • 避免强制解包（!!），用更安全的替代方案
2. 不可变性
   • 默认使用 val 而非 var，减少可变状态
   • 数据类的 copy() 方法实现不可变更新
   • 不可变集合优先于可变集合
3. 数据建模
   • 数据类自动生成 equals、hashCode、toString
   • 密封类表达有限的状态机，确保所有分支都被处理
   • 值类（Value Class）提供类型安全零开销封装
4. 异步编程
   • 协程实现结构化的并发，自动管理生命周期
   • Flow 处理响应式数据流，支持各种操作符
   • 正确处理取消和清理，避免内存泄漏
5. 代码简化
   • 表达式函数让简单逻辑一目了然
   • 作用域函数（let/apply/also/run/with）根据场景选择最合适的
   • 扩展函数为现有类型添加行为，无需继承
6. 构建 DSL
   • 用 lambda 接收者和 @DslMarker 创建类型安全的领域特定语言
   • 让配置代码读起来像自然语言

怎么用

写代码时 —— 问它"这种情况下 Kotlin 的推荐写法是什么？"

审查时 —— 把代码发给它，检查有没有更地道的写法

学习时 —— 了解 Kotlin 的各种特性在什么场景下使用

重构时 —— 把冗长的代码改成更简洁的 Kotlin 风格

核心原则

写 Kotlin 时，记住这几条原则：

1. 空安全是类型系统的一部分 —— 用好可空类型，让编译器帮你发现问题
2. 默认不可变 —— 用 val 和数据类减少可变状态
3. 简洁但可读 —— 利用语法糖，但不要为了短而牺牲可读性
4. 结构化并发 —— 用协程管理异步操作，避免回调地狱
5. 扩展优于继承 —— 用扩展函数添加功能，不要滥用继承

适用场景

• Kotlin 后端服务开发
• Android 应用开发
• Kotlin 多平台项目
• 代码审查和重构
• 学习 Kotlin 最佳实践

不适用场景

• 非 Kotlin 项目（如 Java、Scala）
• 纯前端开发（虽然 Kotlin/JS 存在，但主要针对后端和移动端）
• 不需要 Kotlin 特性的简单脚本