本文详解如何在 kivy 中为自定义圆角 textinput 分别控制文本颜色和背景色，解决因半透明背景导致文字不可见的问题，并提供可复用的 kv 语言结构与关键注意事项。
在 Kivy 中，TextInput 的文本颜色（即输入内容的颜色）默认由 foreground_color 属性控制（注意：不是 color），而背景绘制完全依赖 canvas.before 或 canvas.after —— 但直接在 TextInput 类定义中修改 canvas.before 会覆盖其内置渲染逻辑，导致光标消失、文本裁剪异常甚至完全不可见。原问题中尝试将 rgba 不透明度设为 1 后文字“彻底消失”，正是因为错误地用 canvas.before 覆盖了整个控件区域，遮挡了文本层。
✅ 正确解法是：分离关注点——
- 使用 foreground_color 显式设置文本颜色（推荐 RGBA 格式，确保高对比度）；
- 将圆角背景绘制移至 TextInput 的父容器（如 BoxLayout 或 FloatLayout）中，避免干扰 TextInput 自身渲染；
- 保持 TextInput 的 background_color: [0,0,0,0]（全透明），使其仅负责内容渲染。
以下是优化后的完整实现（兼容 Kivy 2.0+）：
# test.kv
Manager:
Screeen:
:
# 关键：独立设置文本颜色（RGBA），确保在任意背景上清晰可见
foreground_color: 1, 1, 1, 1 # 白色文本（可按需调整）
background_color: 0, 0, 0, 0 # 完全透明，不干扰自定义背景
padding: [12, 8, 12, 8] # 增加内边距，避免文字贴边
:
name: "Screeen"
FloatLayout:
size: root.width, root.height
# 圆角背景容器（纯装饰层）
BoxLayout:
size_hint: .45, .1
pos: root.width * 0.25, root.height * 0.5
# 绘制底层圆角背景
canvas.before:
Color:
rgba: .4, .2, .8, .7 # 深紫半透明背景色
RoundedRectangle:
size: self.size
pos: self.pos
radius: [24]
# 叠加在上方的 TextInput（无背景，仅文本）
RoundedTextInput:
size_hint: .45, .1
pos: root.width * 0.25, root.height * 0.5
hint_text: "请输入..."
font_size: '16sp' ? 关键注意事项：
- ❌ 避免在 TextInput 的 canvas.before 中绘制背景——这会破坏其内部 canvas 渲染顺序；
- ✅ foreground_color 是控制文本/提示文字/光标的唯一可靠属性（color 在 TextInput 中无效）；
- ? 若需阴影或描边效果，应在父容器 canvas.after 中添加额外图层，而非修改 TextInput 自身；
- ? 颜色值务必使用 RGBA 元组（如 [1,1,1,1]），Kivy 不接受 CSS 风格颜色名或十六进制。
通过该结构，你既能获得视觉统一的圆角容器，又能保证文本始终以高对比度清晰显示，彻底规避透明度冲突问题。
