Kivy 中直接在未完成布局计算的 Widget 上绘制 Canvas（如 RoundedRectangle + source）会导致图像位置偏移；根本原因是 widget 的 size 和 pos 在初始化时尚未被父容器正确设置，需延迟至布局就绪后再绘制。
kivy 中直接在未完成布局计算的 widget 上绘制 canvas（如 roundedrectangle + source）会导致图像位置偏移；根本原因是 widget 的 `size` 和 `pos` 在初始化时尚未被父容器正确设置，需延迟至布局就绪后再绘制。
在 Kivy 开发中，使用 canvas（尤其是带 source 的 RoundedRectangle）为自定义 Widget（如 CardGL）添加背景图时，常遇到图像“视觉上偏离中心”或与边框/子控件错位的问题——正如你截图中背景图未对齐 Header 所示。这并非坐标写错，而是典型的时机问题：你在 Factory.CardGL() 实例化后立即访问 card1.size 和 card1.pos，但此时该 Widget 尚未被父容器（如 GridLayout 或 BoxLayout）完成尺寸分配和位置计算，self.size 和 self.pos 仍为默认值（如 (100, 100)、(0, 0)），导致 Canvas 绘制在错误位置。
✅ 正确做法是：将 Canvas 绘制逻辑推迟到 Widget 完成首次布局之后执行。推荐使用 Clock.schedule_once() 配合极短延迟（如 0.01s），或更健壮地监听 on_size/on_pos 事件（首次触发时执行一次）。以下是优化后的实现方案：
from kivy.clock import Clock
from kivy.graphics import Color, RoundedRectangle
# 在 App 类或合适的作用域中
def create_and_setup_card(self):
card1 = Factory.CardGL()
# 先添加到界面树（触发后续布局计算）
target_layout = sm.get_screen('sm3').ids.Dashboard_SM_1.get_screen('DB_MAIN').ids.DB_MAIN_BL_T_01
target_layout.add_widget(card1)
sm.get_screen('sm3').ids.Dashboard_SM_1.get_screen('DB_MAIN').ids['card_1'] = weakref.ref(card1)
# 延迟绘制：确保 size/pos 已由父容器正确设置
Clock.schedule_once(
lambda dt: self._draw_background(card1),
0.01
)
def _draw_background(self, widget):
# 清空原有 canvas（可选，避免重复叠加）
widget.canvas.clear()
with widget.canvas:
# 使用当前已生效的真实 size/pos
Color(1, 1, 1, 1) # 白色（或按需设透明度）
RoundedRectangle(
source=self.GS_IMG_LSRC,
size=widget.size,
pos=widget.pos,
radius=[10, 10, 10, 10]
)
⚠️ 注意事项：
-
不要在
__init__或工厂创建时直接操作canvas：此时 Widget 尚未进入渲染管线； -
避免硬编码
size/pos：始终以widget.size和widget.pos为准，它们会在布局阶段自动更新； -
若需响应尺寸变化（如窗口缩放），可绑定
widget.bind(size=self._redraw_bg, pos=self._redraw_bg)，并在_redraw_bg中canvas.clear()后重绘； -
.kv文件中的canvas.before/canvas是声明式静态绘制，适合固定样式；动态背景图建议用 Python 端控制，更灵活可靠。
总结：Kivy 的 Canvas 绘制必须与布局生命周期同步。理解 “widget 创建 → 添加到父容器 → 触发 layout → 更新 size/pos → 渲染 canvas” 这一顺序，是解决对齐问题的关键。延迟绘制不是权宜之计，而是 Kivy 布局机制下的标准实践。
