Jetpack Compose中M3组件OutlinedTextField占位符颜色无法修改

使用M3主题及组件时，文本、边框等其他元素的颜色均可正常修改，但OutlinedTextField的占位符始终显示为黑色。相关代码如下：

颜色定义（Color.kt） #

val md_theme_dark_onSurface = Color(red = 140, green = 207, blue = 242)

文本框颜色配置及使用（LoginView.kt） #

val textFieldColor = OutlinedTextFieldDefaults.colors(
  focusedPlaceholderColor = MaterialTheme.colorScheme.onSurface,
  unfocusedPlaceholderColor = MaterialTheme.colorScheme.onSurface
)

OutlinedTextField(
  value = uiState.username,
  keyboardOptions = KeyboardOptions(imeAction = ImeAction.Next),
  onValueChange = { viewModel.setUsername(it) },
  placeholder = { Text("Username") },
  leadingIcon = {
    Image(painter = painterResource(id = R.drawable.user), contentDescription = null)
  },
  colors = textFieldColor
)

边框、图标在聚焦/失焦状态下颜色可正常变化，但占位符无论深色还是浅色主题均保持黑色。

可能的解决方法 #

• 直接为占位符Text组件指定颜色
  绕开OutlinedTextFieldDefaults.colors的配置，直接在占位符的Text组件中设置目标颜色：

  placeholder = { Text("Username", color = MaterialTheme.colorScheme.onSurface) }
  

• 检查主题全局文本样式的覆盖
  M3中OutlinedTextField的占位符默认使用typography.bodySmall样式，确认主题的Typography配置中是否硬编码了该样式的颜色为黑色，导致局部配置失效：

  // 排查是否存在类似强制配置
  val Typography = Typography(
    bodySmall = TextStyle(
      color = Color.Black // 此配置会强制占位符颜色为黑色
    )
  )
  

• 验证颜色值是否正确注入
  临时将占位符颜色替换为显眼的测试色（如Color.Red），排查是否是onSurface颜色未正确注入到主题中：

  val textFieldColor = OutlinedTextFieldDefaults.colors(
    focusedPlaceholderColor = Color.Red,
    unfocusedPlaceholderColor = Color.Red
  )
  

• 升级Compose M3版本
  部分旧版Compose M3存在占位符颜色配置失效的已知问题，尝试升级到最新稳定版（如androidx.compose.material3:material3:1.2.0及以上）。
• 确认深色主题的颜色赋值逻辑
  检查主题切换代码，确保md_theme_dark_onSurface仅在深色主题下被赋值给MaterialTheme.colorScheme.onSurface，而非始终使用浅色主题的颜色值。

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