Material Design 3中OutlinedTextFieldDefaults导入失效问题求助

在Android Studio Giraffe（2022.3.1 Patch 3）开发Compose应用时，遇到androidx.compose.material3.OutlinedTextFieldDefaults导入失效、代码无法正常运行的问题，即便添加了@OptIn(ExperimentalMaterial3Api::class)也没解决。可以按以下步骤排查修复：

1. 确认Material3依赖版本 #

首先检查Module级别的build.gradle文件，确保Material3依赖是最新稳定版，且正确引入：

implementation "androidx.compose.material3:material3:1.1.2" // 可替换为当前最新稳定版本

同步Gradle后再重新检查导入是否正常。

2. 清理Android Studio缓存并重启 #

缓存异常经常导致这类识别问题，操作路径：
File → Invalidate Caches...，勾选Clear file system cache and local history，点击Invalidate and Restart重启IDE。

3. 核对导入语句正确性 #

确保导入的是Material3包下的类，而非Material（M2）的：

import androidx.compose.material3.OutlinedTextFieldDefaults // 正确路径
// 避免误导入：import androidx.compose.material.OutlinedTextFieldDefaults（这是M2的类）

4. 扩大Experimental注解的作用范围 #

虽然你已经在函数上添加了@OptIn(ExperimentalMaterial3Api::class)，但可以尝试将注解加到文件顶部，让整个文件生效：

@file:OptIn(ExperimentalMaterial3Api::class)

package com.your.package.name // 你的包声明

// 后续代码...

5. 匹配Compose Compiler版本 #

Material3依赖需要和Compose Compiler版本兼容，在Module级别的build.gradle中检查：

composeOptions {
    kotlinCompilerExtensionVersion = "1.4.3" // 需与Material3版本对应，比如1.1.x的Material3对应1.4.x的Compiler
}

如果版本不匹配，Android Studio通常会给出提示，直接点击提示的修复选项即可。

你的代码示例（修复后可正常运行） #

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun LyricInputForm(
    lyricDetails: LyricDetails,
    modifier: Modifier = Modifier,
    onValueChange: (LyricDetails) -> Unit = {},
    enabled: Boolean = true
) {
    Column(
        modifier = modifier,
        verticalArrangement = Arrangement.spacedBy(dimensionResource(id = R.dimen.padding_medium))
    ) {
        OutlinedTextField(
            value = lyricDetails.songName,
            onValueChange = { onValueChange(lyricDetails.copy(songName = it)) },
            label = { Text(stringResource(R.string.song_name_req)) },
            colors = OutlinedTextFieldDefaults.colors(
                focusedContainerColor = MaterialTheme.colorScheme.secondaryContainer,
                unfocusedContainerColor = MaterialTheme.colorScheme.secondaryContainer
            ),
            modifier = Modifier.fillMaxWidth(),
            enabled = enabled,
            singleLine = true
        )
        OutlinedTextField(
            value = lyricDetails.artistName,
            onValueChange = { onValueChange(lyricDetails.copy(artistName = it)) },
            label = { Text(stringResource(R.string.artist_name_req)) },
            colors = OutlinedTextFieldDefaults.colors(
                focusedContainerColor = MaterialTheme.colorScheme.secondaryContainer,
                unfocusedContainerColor = MaterialTheme.colorScheme.secondaryContainer
            ),
            modifier = Modifier.fillMaxWidth(),
            enabled = enabled,
            singleLine = true
        )
        OutlinedTextField(
            value = lyricDetails.lyricData,
            onValueChange = { onValueChange(lyricDetails.copy(lyricData = it)) },
            label = { Text(stringResource(R.string.lyric_data_req)) },
            colors = OutlinedTextFieldDefaults.colors(
                focusedContainerColor = MaterialTheme.colorScheme.secondaryContainer,
                unfocusedContainerColor = MaterialTheme.colorScheme.secondaryContainer
            ),
            modifier = Modifier.fillMaxWidth(),
            enabled = enabled,
            singleLine = true
        )
        if (enabled) {
            Text(
                text = stringResource(required_fields),
                modifier = Modifier.padding(start = dimensionResource(id = R.dimen.padding_medium))
            )
        }
    }
}

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