Kivy按钮设置固定尺寸时出现x/y轴白线问题求助

问题重现 #

当Kivy Button的width或height设置过小时，按钮的x轴或y轴会出现白线；若两者尺寸都偏小，两个轴都会出现该问题。即使按钮没有文本，白线依然存在。调整字体样式、背景参数都无法消除，只有增大按钮尺寸能解决。

相关代码片段：

label_height = 30
label_width = 100

Button(text="Don't reset",
        size_hint=(None, None),
        size=(self.label_width, self.label_height),
        background_normal="",
        background_color=(1, .2, .2, .4)
        )

问题原因 #

这是Kivy Button默认背景渲染逻辑导致的：即使设置了background_normal=""使用纯色背景，按钮内部的border拉伸机制仍会生效，当尺寸小于一定阈值时，边缘计算会出现渲染 artifacts（白线），和文本内容无关。

解决办法 #

1. 取消按钮的border设置 #

直接将border属性设为(0,0,0,0)，强制关闭背景的拉伸逻辑，避免小尺寸下的边缘异常：

Button(text="Don't reset",
        size_hint=(None, None),
        size=(self.label_width, self.label_height),
        background_normal="",
        background_color=(1, .2, .2, .4),
        border=(0, 0, 0, 0)
        )

2. 用Canvas自定义绘制背景 #

绕过Kivy Button默认的背景渲染，直接通过Canvas绘制纯色背景，彻底避免白线问题：

from kivy.graphics import Color, Rectangle

btn = Button(text="Don't reset",
            size_hint=(None, None),
            size=(self.label_width, self.label_height)
            )

# 在按钮的canvas.before层绘制背景
with btn.canvas.before:
    Color(1, .2, .2, .4)  # 对应原background_color的RGBA值
    btn.rect = Rectangle(pos=btn.pos, size=btn.size)

# 绑定按钮的位置和尺寸变化，确保背景同步更新
btn.bind(pos=lambda _, new_pos: setattr(btn.rect, 'pos', new_pos))
btn.bind(size=lambda _, new_size: setattr(btn.rect, 'size', new_size))

3. 微调尺寸到安全阈值 #

如果不想修改渲染逻辑，可以测试找到不会出现白线的最小尺寸（比如将高度调到32、宽度调到104，具体数值可能因Kivy版本、系统DPI略有不同），这种方法适合快速临时修复。

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