使用yview_scroll滚动tk.Text组件时出现黑块异常求助

问题场景与现象 #

在Notebook的Frame中嵌套了一个tk.Text组件，该组件内嵌入了包含Header Frame和内容Text的tk.Frame。执行程序化滚动时遇到以下异常：

• 调用self.yview_scroll(-2, "units")向上滚动主Text组件时，会出现纯黑背景块，继续滚动后该块消失
• 向下滚动无此问题，鼠标滚轮或滚动条手动滚动也完全正常
• 异常仅在特定窗口尺寸（如启动参数--width 900 --height 1000）下触发

嵌入Snippet Frame的实现代码 #

def format_snippets(self) -> None:
    from .snippet import Snippet
    start_index = self.position
    text = self.get(start_index, "end-1c")
    pattern = r"^```([\w#]*)\n(.*?)\n```$"
    matches = []

    for match in re.finditer(pattern, text, flags=re.MULTILINE | re.DOTALL):
        language = match.group(1)
        content_start = match.start(2)
        content_end = match.end(2)
        matches.append((content_start, content_end, language))

    for content_start, content_end, language in reversed(matches):
        start_line_col = self.index_at_char(content_start, start_index)
        end_line_col = self.index_at_char(content_end, start_index)
        snippet_text = self.get(start_line_col, end_line_col)
        self.delete(f"{start_line_col} - 1 lines linestart", f"{end_line_col} + 1 lines lineend")

        snippet = Snippet(self, snippet_text, language)
        self.window_create(f"{start_line_col} - 1 lines", window=snippet)
        self.snippets.append(snippet)

临时解决方案 #

通过计算单行内容在整体滚动范围内的占比，使用yview_moveto替代yview_scroll实现滚动，避免重绘异常：

def get_fraction(self, num_lines: int = 1) -> float:
    total_lines = self.count("1.0", "end-1c lineend", "displaylines")[0]
    fraction = num_lines / total_lines
    return fraction

def scroll_up(self, check: bool = False) -> None:
    fraction = self.get_fraction()
    self.yview_moveto(self.yview()[0] - fraction)

问题推测 #

这类黑块异常通常是Tkinter处理嵌入窗口的滚动重绘时的同步问题：

• yview_scroll基于单位/行的增量滚动，在特定窗口尺寸下，嵌入Frame的尺寸计算与Text组件的滚动逻辑不同步，导致局部重绘间隙，出现黑块
• yview_moveto基于滚动比例操作，能触发更完整的界面重绘流程，避免局部重绘的异常情况

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