本文详解如何在 kivy 中自定义圆角 textinput 的文字颜色（foreground color）和背景区域颜色（roundedrectangle 背景），避免因半透明遮罩导致文字不可见的问题。
在 Kivy 中，TextInput 默认的 foreground_color（即文字颜色）由其内部绘制逻辑控制，不会受 canvas.before 中的 Color 指令影响——后者仅作用于背景图层。因此，当你在 RoundedTextInput@TextInput 的 canvas.before 中设置 rgba: .4, .2, .8, .5 时，该颜色仅填充圆角矩形背景，而文字仍使用默认的黑色（或主题色），在深色/半透明背景上极易难以辨识；若盲目提高 alpha 值（如设为 1），又可能因 background_color: 0,0,1,0（完全透明）导致文字被底层内容干扰或视觉混淆。
正确解法是：分离关注点——将圆角背景绘制与文字渲染解耦，利用 canvas.after 在 TextInput 上层（或同级容器）独立绘制背景，并显式设置 TextInput 的 foreground_color 属性控制文字颜色。
以下是推荐的结构化实现方案：
✅ 正确做法：用 BoxLayout 容器承载圆角背景 + 独立 TextInput
# test.kv Manager: Screeen: # 关键：显式设置文字颜色（RGBA），确保高对比度 foreground_color: 1, 1, 1, 1 # 白色文字（可按需调整） background_color: 0, 0, 0, 0 # 完全透明背景，避免双层遮罩 padding: [12, 8, 12, 8] # 可选：增加内边距提升可读性 font_size: 16 : name: "Screeen" FloatLayout: size: root.width, root.height # 使用 BoxLayout 作为圆角背景容器（位置与尺寸与 TextInput 一致） BoxLayout: size_hint: (.45, .1) pos: root.width * 1 / 4, root.height * 1 / 2 # 绘制不透明圆角背景（置于 TextInput 下方） canvas.before: Color: rgba: .4, .2, .8, 1 # 纯色背景，无透明度干扰 RoundedRectangle: size: self.size pos: self.pos radius: [24] # TextInput 置于上方，文字颜色独立可控 RoundedTextInput: size_hint: (.45, .1) pos: root.width * 1 / 4, root.height * 1 / 2 ⚠️ 注意事项：
- 不要在 TextInput 的 canvas.before 中绘制背景：这会与 foreground_color 渲染顺序冲突，且无法隔离文字图层。
- foreground_color 必须显式声明：默认值为 [1, 1, 1, 1]（白色），但若主题或父容器影响了颜色继承，务必覆盖。
- background_color 应设为完全透明（0,0,0,0）：避免与外部圆角背景叠加产生意外灰阶或模糊。
- 若需响应式交互（如聚焦变色），可结合 on_focus 事件动态修改 foreground_color 或 canvas.before 的 Color.rgba。
✅ 进阶提示：支持焦点状态样式
foreground_color: (1, 1, 1, 1) if self.focus else (.8, .8, .8, 1) # … 其他属性保持不变 通过这种容器分离 + 属性显式控制的方式，你既能获得美观的圆角 ui，又能确保文字始终清晰可读，彻底规避透明度叠加导致的显示异常问题。