Jetpack Compose(Material 3)中TextField()无法使用，提示未解析引用求助

出现「Unresolved reference: TextField」错误，核心原因是未导入TextField对应的包或项目缺少Compose Material库依赖，按以下步骤解决：

1. 确认项目依赖配置 #

打开模块级别的build.gradle（或build.gradle.kts），检查是否包含Compose Material相关依赖，没有的话添加进去：

dependencies {
    // 基础Compose UI依赖
    implementation "androidx.compose.ui:ui:1.6.0"
    // Material库（TextField属于这个库）
    implementation "androidx.compose.material:material:1.6.0"
    // 预览与工具依赖
    implementation "androidx.compose.ui:ui-tooling-preview:1.6.0"
    debugImplementation "androidx.compose.ui:ui-tooling:1.6.0"
}

版本号可以根据你使用的Compose版本调整，确保所有Compose库版本一致。

2. 导入TextField的正确包 #

在你的Composable函数所在的Kotlin文件顶部，添加导入语句：

• 如果你用的是传统Material设计：

import androidx.compose.material.TextField

• 如果你用的是Material 3（新版设计系统）：

import androidx.compose.material3.TextField

3. 完善TextField的功能实现（可选） #

原代码的TextField缺少状态管理，无法保存用户输入，建议补充状态逻辑，还可以限制输入为数字：

import androidx.compose.material.Text
import androidx.compose.material.TextField
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.getValue
import androidx.compose.runtime.setValue
import androidx.compose.ui.text.input.KeyboardOptions
import androidx.compose.ui.text.input.KeyboardType

@Composable
fun EditNumberField() {
    // 用remember+mutableStateOf管理输入状态
    var inputValue by remember { mutableStateOf("") }
    TextField(
        value = inputValue,
        onValueChange = { inputValue = it },
        label = { Text("输入数字") },
        // 限制键盘为数字类型
        keyboardOptions = KeyboardOptions.Default.copy(keyboardType = KeyboardType.Number)
    )
}

如果是Material 3版本，代码调整为：

import androidx.compose.material3.Text
import androidx.compose.material3.TextField
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.getValue
import androidx.compose.runtime.setValue
import androidx.compose.ui.text.input.KeyboardOptions
import androidx.compose.ui.text.input.KeyboardType

@Composable
fun EditNumberField() {
    var inputValue by remember { mutableStateOf("") }
    TextField(
        value = inputValue,
        onValueChange = { inputValue = it },
        label = { Text("输入数字") },
        keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number)
    )
}

4. 同步并重建项目 #

添加依赖后点击Android Studio的「Sync Now」同步项目，必要时执行「Build > Clean Project」和「Build > Rebuild Project」，确保依赖和代码生效。

内容的提问来源于stack exchange，提问作者Uday Chaudhary