kotlin-springboot-rules

项目结构与组织

1. 将你的源代码分组到明确定义的包中，如 controller、service、repository 和 model，以分离关注点并提高可维护性。
2. 组织你的文件系统，使每个目录都镜像 Kotlin 的包名（例如，将 com.myapp.users 放在 src/main/kotlin/com/myapp/users 下）。
3. 每个 Kotlin 文件都以其包含的主要类或概念命名，以使代码库更易于导航和理解。
4. 避免使用像 Utils.kt 这样模糊的文件名；相反，使用简洁且有意义的名称，以反映文件内容的目的。
5. 将你的 Spring Boot 应用程序入口点放在根包中，并按层或功能组织子包，以帮助 Spring 高效地扫描和组织组件。

编码风格与约定

1. 类和对象名使用 PascalCase，函数和变量名使用 camelCase，常量名使用 UPPER_SNAKE_CASE，以遵循 Kotlin 的命名约定并提高可读性。
2. 默认使用 val 声明变量，仅在需要可变性时才使用 var，以促进更安全、更可预测的代码。

   val maxConnections = 10    // 不可变引用
   var currentUsers = 0       // 可变的，如果可能，尽量避免
   

3. 将变量的作用域限制在其实际使用的地方——函数内部或更小的代码块中——以避免意外误用，并使代码更易于遵循。
4. 使用 4 空格缩进、在运算符和逗号周围使用适当的间距，以及编写简短、专注的函数来统一格式化你的代码，以提高清晰度和可维护性。
5. 编写清晰且富有表现力的代码，而不是巧妙的单行代码；将复杂的逻辑分解为中间变量或命名良好的函数，以提高可读性。
6. 为类、函数和变量使用描述性的名称以传达意图，并避免使用像 '-Manager' 或 '-Helper' 这样没有实际意义的模糊后缀。
7. 保持属性的 getter 和 setter 简单且不含复杂逻辑；如果需要复杂的行为，请将其移至单独的方法中，以保持属性访问的可预测性。

地道的 Kotlin 用法

1. 使用数据类（data class）定义 DTO 和实体，这样你就可以获得像 equals() 和 copy() 这样的有用方法，而无需编写样板代码。
2. 使用默认参数和命名参数替换重载的构造函数，以简化函数调用并使其更具表现力。

   // Kotlin – 使用默认参数
   fun createConnection(host: String, secure: Boolean = true) { … }
   
   createConnection("example.com")                      // 使用默认的 secure=true
   createConnection(host = "test.com", secure = false)  // 使用命名参数以提高清晰度
   

3. 使用 when 表达式代替冗长的 if-else 链，以编写更清晰、更易读的条件逻辑，从而清楚地处理每种情况。
4. 创建扩展函数而不是工具类，以更自然、更易读的方式为现有类型添加可重用行为。

   fun String.capitalizeFirst(): String = replaceFirstChar { it.uppercaseChar() }
   
   println("kotlin".capitalizeFirst())  // 打印 "Kotlin"
   

5. 使用作用域函数如 apply、let、also、run 和 with 来减少重复，并清晰地表达对象配置或空安全操作。
6. 仅在必要时将变量声明为可空，并使用安全调用运算符（?.）和 Elvis 运算符（?:）来处理它们，以避免运行时崩溃。
7. 避免使用非空断言（!!），而是提供回退值或显式的空检查，以编写更安全、更可预测的代码。
8. 立即处理来自 Java API 的平台类型，通过将它们显式转换为 String 或 String?，以避免在你的 Kotlin 代码中传播可空性的不确定性。
9. 使用 Kotlin 的函数式集合操作如 filter、map 和 forEach 代替手动循环，以编写简洁且富有表现力的数据转换逻辑。

   // 命令式方法
   val activeUsers = mutableListOf<User>()
   for (user in users) {
       if (user.isActive) activeUsers.add(user)
   }
   
   // 地道的函数式方法
   val activeUsers = users.filter { it.isActive }
   

10. 当逻辑清晰时，将简单函数转换为单表达式函数，以消除不必要的语法并提高代码的简洁性。

    fun toDto(entity: User) = UserDto(name = entity.name, email = entity.email)
    

11. 使用字符串模板（$var 或 ${expression}）构建字符串，而不是使用拼接，并使用三引号字符串处理干净的多行文本。