【Bug已解决】The keyboard shortcut cmd-e doesn't put the currently selected text on the find pasteboard. 解决方案
原始报错:The keyboard shortcut cmd-e doesn't put the currently selected text on the find pasteboard. 场景:在文本编辑器里选中一段文字,按下
Cmd-E(本应把选中文本放进"查找粘贴板",之后Cmd-G用它来查找),结果查找粘贴板是空的——Cmd-E好像没生效,后续查找用的是旧内容或空内容。 关键词:键盘快捷键、选区捕获、命令上下文、查找粘贴板、剪贴板写入、焦点视图。
一、现象长什么样
复现步骤:
- 在编辑器里用鼠标选中一段文字,比如 "timeout";
- 按
Cmd-E(约定为"把选中文本设为查找内容"); - 再到别处按
Cmd-G查找下一个; - 发现查找的是别的内容,或者弹出"查找内容为空的"提示。
Cmd-E按下去时没有任何报错,但查找粘贴板没有被更新。用户以为是快捷键坏了,或者以为是系统问题。本质是:快捷键的处理逻辑没有先去读取"当前选中的文字",就直接把某个默认/旧值写进了查找板(甚至根本没写)。
二、背景:快捷键执行前为什么要先抓选区
很多编辑器快捷键的语义依赖于"当前上下文":
Cmd-C复制:依赖当前选区;Cmd-E设查找内容:依赖当前选区;Cmd-L选中当前行:依赖光标位置。
这类命令正确执行的前提是:快捷键被触发时,处理函数在执行动作之前,先从"拥有焦点的视图"读取最新的选区/光标状态。如果处理函数用的是"编辑器初始化时缓存的选区"或者"上次某次操作的选区",就会和实际选区脱节。
Cmd-E的特殊之处还在于它写的是"查找粘贴板"——一个独立的、专门给查找用的粘贴板(和普通的复制粘贴板分开)。如果写入逻辑连"读选区"这步都跳过了,查找板自然不会被更新。
三、根因:handler 直接用缓存选区,没在触发瞬间读取
常见根因:
- 选区缓存过期:编辑器只在
selectionchange事件里更新一个self.selection字段,但Cmd-E的处理函数绑定的是另一个早已过期的副本。 - handler 不读视图:快捷键回调里直接操作"查找板 = 某个固定字符串",完全没去问"现在选了什么"。
- 焦点错乱:按下快捷键时焦点其实不在文本视图(比如在侧边栏),选区为空,handler 拿到空串写入,等于没设。
- 写入目标错:本应写"查找粘贴板",却写到了普通剪贴板,于是
Cmd-G读查找板时还是旧的。
下面用最小模型复现第 2 类(最典型),再给修复。
四、最小可运行复现
用纯 Python 模拟"编辑器 + 查找板 + 快捷键"。错误写法:Cmd-E的 handler 不读当前选区,直接写死或写缓存。
class Editor: def __init__(self): self.selection = "" # 选区缓存 self.find_pasteboard = "" # 查找粘贴板 def on_select(self, text: str): self.selection = text def cmd_e_wrong(self): # 错误:没读当前选区,直接把旧的 find_pasteboard 又写回去 # (或者干脆写成固定值,这里复现"写缓存旧值") self.find_pasteboard = self.find_pasteboard if __name__ == "__main__": ed = Editor() ed.on_select("timeout") # 用户选中了 timeout ed.cmd_e_wrong() # 按 Cmd-E print("查找板内容:", repr(ed.find_pasteboard)) # '' (空的,没更新!)运行后查找板还是空字符串——Cmd-E对选中文本毫无作用,正好对应报错。
五、方案:handler 在执行前先快照当前选区
第一层修复:Cmd-E触发时,立刻从拥有焦点的视图读取最新选区,再写入查找板。选区必须是"触发这一刻"的,不是缓存。
class EditorFixed: def __init__(self): self.selection = "" self.find_pasteboard = "" def on_select(self, text: str): self.selection = text def get_active_selection(self) -> str: # 关键:每次都向焦点视图要"此刻"的选区 return self.selection def cmd_e(self): text = self.get_active_selection() if not text: return False # 没选区就不写,给调用方反馈 self.find_pasteboard = text return True if __name__ == "__main__": ed = EditorFixed() ed.on_select("timeout") ok = ed.cmd_e() print("写入成功:", ok) # True print("查找板内容:", repr(ed.find_pasteboard)) # 'timeout'现在Cmd-E真正把当前选中文本放进了查找板。
六、方案:快捷键绑定到正确焦点视图
第二层:系统可能把快捷键事件发给了一个全局 handler,而该 handler 不知道"当前焦点在哪个视图"。正确做法是 handler 通过"焦点管理器"拿到活跃视图再读选区:
class FocusManager: def __init__(self): self.active_view = None def set_active(self, view): self.active_view = view class TextView: def __init__(self, focus: FocusManager): self.focus = focus self._selection = "" self.find_pasteboard = "" def on_select(self, text: str): self._selection = text def cmd_e(self): # 先从焦点管理器确认自己是不是活跃视图 if self.focus.active_view is not self: return False # 焦点不在我,拒执行 text = self._selection if not text: return False self.find_pasteboard = text return True if __name__ == "__main__": fm = FocusManager() tv = TextView(fm) fm.set_active(tv) tv.on_select("segmentation") print("Cmd-E 结果:", tv.cmd_e()) # True print("查找板:", tv.find_pasteboard) # 'segmentation'焦点校验避免"快捷键被别的面板拦截、却对错误视图生效"的混乱。
七、方案:写入正确的板,并给失败反馈
第三层:明确"查找板"和"普通剪贴板"是两个不同目标,且写入失败要可见:
from typing import Dict class PasteboardStore: """抽象两套粘贴板:普通复制板 与 查找板。""" def __init__(self): self.boards: Dict[str, str] = {"general": "", "find": ""} def write(self, board: str, text: str) -> bool: if board not in self.boards: return False self.boards[board] = text return True def read(self, board: str) -> str: return self.boards.get(board, "") class FindCommand: def __init__(self, view, boards: PasteboardStore): self.view = view self.boards = boards def execute(self) -> bool: text = self.view._selection if not text: # 可见反馈,而不是静默 print("[warn] Cmd-E: 没有选中文本,查找板未更新") return False ok = self.boards.write("find", text) if not ok: print("[warn] Cmd-E: 查找板写入失败") return False print(f"[ok] 查找内容已设为: {text}") return True if __name__ == "__main__": fm = FocusManager() tv = TextView(fm); fm.set_active(tv) store = PasteboardStore() cmd = FindCommand(tv, store) tv.on_select("deadlock") cmd.execute() # 写入 find 板 print("查找板读出:", store.read("find")) # 'deadlock' print("普通板不变:", repr(store.read("general"))) # ''把"查找板"独立出来,写入目标和读取目标一致,Cmd-G才能拿到正确内容;任何失败都打印提示,不再静默。
八、验证:把"选区捕获 + 写入正确板"锁进测试
def test_cmd_e_captures_current_selection(): tv = TextView(FocusManager()); tv.focus.set_active(tv) store = PasteboardStore(); cmd = FindCommand(tv, store) tv.on_select("race") assert cmd.execute() is True assert store.read("find") == "race" def test_cmd_e_no_selection_does_nothing(): tv = TextView(FocusManager()); tv.focus.set_active(tv) store = PasteboardStore(); cmd = FindCommand(tv, store) assert cmd.execute() is False # 无选区,不写 assert store.read("find") == "" if __name__ == "__main__": test_cmd_e_captures_current_selection() test_cmd_e_no_selection_does_nothing() print("Cmd-E 选区捕获与写入测试通过。")九、排查清单("快捷键没作用选区"按顺序查)
- 选区读取:快捷键 handler 是否在执行动作前读取"当前"选区?还是用了过期缓存?
- 触发时机:选区是否在
keydown这一刻实时获取?有无时序错位? - 焦点视图:快捷键事件发给了哪个视图?活跃视图是否就是用户以为的那个?
- 写入目标:写的是"查找板"还是普通剪贴板?读取方是否一致?
- 空选区:没选中时 handler 怎么做?静默跳过还是提示用户?
- 多板区分:查找板/复制板/主剪贴板是否混淆?
- 反馈:写入失败是否有可见提示,还是完全静默?
十、小结
"Cmd-E没把选中文本放进查找板"是快捷键 handler 跳过"读取当前选区"这步导致的:它要么写缓存旧值、要么写错目标板,选区与动作脱节。修复三层:
- 先抓选区:handler 在执行前实时读取焦点视图的当前选区;
- 焦点校验:通过焦点管理器确认命令作用在正确的视图上;
- 写对板 + 给反馈:明确写入"查找板"而非普通剪贴板,失败可见不静默。
核心原则:依赖上下文的快捷键,必须在触发瞬间重新获取上下文,而不是相信任何可能已经过期的缓存。把"读取当前选区"作为这类命令的第一步,选中即生效,查找板才会如约更新。