Kotlin学习2.1：Kotlin的基本语法

• Kotlin代码的基本语法
• • 命名格式
  • 包名
  • 类和接口
  • 方法
  • 字段（Fields）
  • 变量和参数
  • 其他
• Kotlin中的注释
• • 单行注释和多行注释
  • 文档注释

Kotlin代码的基本语法

命名格式

总体来说，Kotlin命名格式要和Java命名规范保持一致，因为Kotlin也是JVM兼容的语言。

包名

包的命名规则和Java一样：全小写，当遇到多个词连接的场景，不要使用下划线(_)和连字号(-)。

推荐：

package vn.asiantech.android
           

不推荐：

package Vn.Asiantech.Android
           

类和接口

命名遵守大驼峰规则（首字母大写）。

推荐：

HomeActivity
MainFragment
           

方法

推荐：

setData
getApiNews
           

字段（Fields）

总体来说，字段命名遵守小驼峰规则，不建议使用匈牙利法。

推荐：

class MyClass {
  var publicField: Int = 0
  val person = Person()
  private var privateField: Int?
}
           

而伴生对象中的常量定义要遵守规则：全大写，单词连接使用下划线。

companion object {
  const val THE_ANSWER = 42
}
           

变量和参数

一句话概括： 小驼峰命名法。

不建议使用单个字符的变量，除非是循环中的临时变量。

其他

首字母缩略词作为完整单词看待，适时选择命名规则。

推荐：

XMLHTTPRequest
URL: String? 
findPostByID
           

不推荐：

XmlHttpRequest
url: String
findPostById
           

Kotlin中的注释

Kotlin的注释与Java基本保持一致，Kotlin注释同样支持单行注释、多行注释和文档注释。

单行注释和多行注释

单行注释就是在程序中注释一行代码，在Kotlin中，将双斜线（//）放在需要注释的内容之前就可以了。

多行注释是指一次性地将程序中的多行代码注释掉，在Kotlin中，使用“/”和“/”将程序中需要注释的内容包含起来。

Java语言的多行注释不支持嵌套，而Kotlin的多行注释支持嵌套。

/*
    这是一个主函数的多行注释，
    看一下Kotlin是不是真的方便呢。
 */
fun main(args: Array<String>) {
    //单行注释
    println("Hello World!")
    /*
    这是第一个多行注释的开头
    /*
    这是一个内嵌的多行注释
    */
     这是第一个多行注释的结尾
     */

}
           

文档注释

Kotlin的文档注释和Java相同，*同样使用/和/来进行文档注释，中间部分全部都是文档注释，会被提取到API文档中。

/**
     * 一个加法方法
     * @param a 第一个加数
     * @param b 第二个加数
     * @return 两个数的和
     */
    public fun add(a: Int, b: Int): Int {
        return a + b
    }
           

博客为个人收集学习，供大家交流学习。

参考书籍：《Kotlin从基础到实践》

参考链接:

Kotlin代码规范 - Android版.

Kotlin怎么注释？.