Kotlin Academy · 课时

主构造函数与属性参数

Q: 「主构造函数与属性参数」这节课中我会学到什么？

使用主构造函数和内联属性声明来声明类。 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用主构造函数和内联属性声明来声明类。

主构造函数与属性参数 是 CoddyKit 上的免费 Kotlin Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Kotlin Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。

主构造函数

Kotlin 类会在类名后的括号中声明其主构造函数。这里没有函数体，只有参数列表。

最简单的类

不带修饰符的主构造函数会隐藏在类名之后。

class Greeter(val name: String) {
    fun greet() = "Hello, $name!"
}
fun main() {
    println(Greeter("Ada").greet())
}

属性参数

在构造函数参数前加上 val 或 var，即可一步将其变为类属性。

class Person(val name: String, var age: Int)
fun main() {
    val p = Person("Bob", 30)
    println("${p.name} is ${p.age}")
    p.age = 31
    println("Now ${p.age}")
}

不使用 val/var 的参数

不带 val/var 的构造函数参数只在构造函数内部有效，可以在 init 块或属性初始化器中使用，但之后无法访问。

class Logger(prefix: String) {
    val msg = "$prefix: ready"
}
fun main() {
    val l = Logger("[INFO]")
    println(l.msg)
    // l.prefix // ERROR — not a property
}

参数默认值

请为构造函数参数提供默认值，以避免编写重载样板代码。

class User(
    val name: String,
    val age: Int = 0,
    val email: String = ""
)
fun main() {
    println(User("Ana").age)               // 0
    println(User("Ben", 25).email)         // ""
    println(User("Cal", 30, "c@x.io").email)
}

命名参数

调用时可以跳过位置顺序，直接为参数指定名称；与默认值结合使用时尤其方便。

class HttpClient(
    val baseUrl: String,
    val timeoutMs: Int = 5000,
    val retries: Int = 3
)
fun main() {
    val c = HttpClient(
        baseUrl = "https://api.example.com",
        retries = 5
    )
    println("retries=${c.retries} timeout=${c.timeoutMs}")
}

构造函数的可见性

使用 private constructor 可以阻止外部实例化；这在配合工厂函数时很常见。

class Singleton private constructor() {
    companion object {
        val instance = Singleton()
    }
}
fun main() {
    val s = Singleton.instance
    println(s)
}

次构造函数

使用 constructor 关键字添加额外的构造函数。它们必须通过 this(...) 委托给主构造函数。

class Point(val x: Int, val y: Int) {
    constructor(value: Int) : this(value, value)
}
fun main() {
    println("${Point(3).x}, ${Point(3).y}") // 3, 3
}

带可见性的构造函数

您可以为每个构造函数分别设置可见性，这对库很有用。

class Lib internal constructor(val key: String) {
    companion object {
        fun create(key: String) = Lib(key)
    }
}
fun main() {
    println(Lib.create("abc").key)
}

init 块回顾

应在构造期间运行的代码应放入 init { } 块中。多个 init 块会按照源代码顺序运行。

class Validator(val value: String) {
    init { require(value.isNotBlank()) { "value cannot be blank" } }
}
fun main() {
    println(Validator("ok").value)
    // Validator("") // throws IllegalArgumentException
}

组合属性与逻辑

属性声明、次构造函数和 init 块可以组合成灵活的初始化流程。

class Account(
    val owner: String,
    initialBalance: Double = 0.0
) {
    var balance: Double = initialBalance
        private set
    init {
        require(initialBalance >= 0) { "balance must be non-negative" }
    }
    fun deposit(amount: Double) { balance += amount }
}
fun main() {
    val a = Account("Alice", 100.0)
    a.deposit(50.0)
    println("${a.owner}: ${a.balance}") // Alice: 150.0
}

快速检查

在主构造函数参数中使用关键字 val 时，它会起什么作用？

回顾

主构造函数位于类头中。请使用 val/var 声明属性参数；不带修饰符的参数仅在构造函数内部有效。添加默认值可以减少重载，并在 init 块中执行初始化逻辑。次构造函数通过 this(...) 进行委托。

常见问题解答

「主构造函数与属性参数」课时是免费的吗？

是的 — 「主构造函数与属性参数」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。

「主构造函数与属性参数」这节课中我会学到什么？

使用主构造函数和内联属性声明来声明类。你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「主构造函数与属性参数」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Kotlin Academy 课中编写并运行代码吗？

能。每节 Kotlin Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Kotlin Academy