WezTerm CopyMode 详解用ClearSelectionMode清除选择而不退出复制模式【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/weztermClearSelectionMode是 WezTerm 中 CopyMode复制模式的一个键盘动作KeyAssignment用于在不退出复制模式的前提下清除当前已激活的文本选择状态。它通常与CopyTo、ClearSelection等动作组合使用实现复制后自动清空高亮选择、光标仍停留在原位置的 Vim 式 yank 工作流。本文基于当前仓库的 ClearSelectionMode.md 文档结合源码实现完整讲解其语义、配置方法、底层原理与实战组合。CopyMode 与选择模式的概念在 WezTerm 中CopyMode 是一个叠加在终端之上的键盘操作模式允许用户脱离鼠标用键盘在回滚缓冲区scrollback中移动光标、建立选区并复制文本。进入 CopyMode 后默认键位见 默认键表提供了移动、翻页、跳转、搜索等一系列操作而**选择模式selection mode**则是其中负责如何扩展选区的子状态Cell按单元格单个字符逐格扩展选区Word按单词扩展选区Line按整行扩展选区Block以起点和当前光标位置为对角定义一个矩形区块SemanticZone扩展到当前语义区域依赖 Shell Integration。这些模式由SetSelectionMode动作设定详见 SetSelectionMode.md而ClearSelectionMode则扮演其逆操作把当前处于激活状态的选区撤销让终端回到 CopyMode 下无选区的干净状态。ClearSelectionMode的语义与典型行为根据原文档ClearSelectionMode的核心行为只有一句话清除当前的 CopyMode 选择模式但不会离开 CopyMode。与之对比CopyMode Close会直接退出复制模式回到正常终端而ClearSelectionMode只做撤销选择这一件事光标与复制模式上下文全部保留。这一语义在源码中体现得十分精确。在 config/src/keyassignment.rs 的CopyModeAssignment枚举中ClearSelectionMode与SetSelectionMode(OptionSelectionMode)是并列的两个变体pub enum CopyModeAssignment { MoveToViewportBottom, MoveToViewportTop, // ... SetSelectionMode(OptionSelectionMode), ClearSelectionMode, // ... }而 GUI 端在 wezterm-gui/src/overlay/copy.rs 的perform_assignment分发逻辑中把它直接路由到渲染器的clear_selection_mode()SetSelectionMode(mode) render.set_selection_mode(mode), ClearSelectionMode render.clear_selection_mode(),源码级的实现原理它到底清除了什么clear_selection_mode()的实际实现位于 wezterm-gui/src/overlay/copy.rs只有两行但每一行都对应一个关键状态fn clear_selection_mode(mut self) { self.start.take(); self.clear_selection(); }self.start.take()清除 CopyOverlay 内部记录的选择起点坐标start: OptionSelectionCoordinate。没有起点后续的select_to_cursor_pos()等选区扩展逻辑就无法再建立选区。self.clear_selection()通过TermWindowNotif::Apply向主窗口发送通知将对应 pane 的selection.origin与selection.range一并取走见 copy.rs从而让终端界面上的高亮选区立刻消失。也就是说清除选择模式在底层同时做了两件事清掉选区锚点start并清掉渲染层的高亮范围origin/range。值得留意的是它不会触碰光标位置也不会修改selection_mode本身——下次用SetSelectionMode重新选择时仍会沿用之前的模式设定Cell/Word/Line/Block 等。这一点与SetSelectionMode的同模式再次设置即切换清除行为见 copy.rs形成互补前者是显式清除后者是隐式切换。实战配置y键 yank 后清除选择且留在复制模式原文档给出的核心示例是在copy_mode键表中把y绑定为复制到主选择 → 清空选择状态 → 清除选择模式但不退出复制模式。这是最典型的应用场景——Vim 用户按下yyank后既希望文本已复制又不希望选区高亮还悬在屏幕上同时还想继续留在复制模式进行下一次移动与选择。local wezterm require wezterm local act wezterm.action return { key_tables { copy_mode { { key y, mods NONE, action act.Multiple { act.CopyTo PrimarySelection, act.ClearSelection, -- clear the selection mode, but remain in copy mode act.CopyMode { ClearSelectionMode }, }, }, }, }, }下面对这个配置逐项拆解方便读者按需增删key y、mods NONE指定裸按y触发不带 Shift/Ctrl/Alt 修饰键。注意键表在key_tables.copy_mode下定义因此只有处于 CopyMode 时该绑定才生效。act.CopyTo PrimarySelection把当前选区内容复制到主选择Primary Selection对应 X11/Wayland 的鼠标中键粘贴缓冲。若你更习惯剪贴板CtrlV 粘贴可换成act.CopyTo Clipboard或act.CopyTo ClipboardAndPrimarySelection。act.ClearSelection清空底层 pane 的选区状态。act.CopyMode { ClearSelectionMode }显式调用清除选择模式动作。由于它不会关闭 CopyMode本次y操作结束后你依然停留在复制模式中可以立即继续移动光标做下一次选择。act.Multiple { ... }把上述多个动作按顺序合并成一次按键触发保证先复制、再清空的执行顺序。如果不希望停留在复制模式、而是复制完直接回到终端可以对比默认键表中y的既有定义——默认行为是复制到ClipboardAndPrimarySelection后执行ScrollToBottom与Close见 默认 CopyMode 键表。两种风格可以并存或按个人习惯替换ClearSelectionMode的价值正在于补上了只清选区、不退模式这一中间选项。与SetSelectionMode的配合完整的选择循环ClearSelectionMode通常与SetSelectionMode成对出现形成完整的开始选择 → 移动扩展 → 复制 → 清除选区循环。例如在 copy_mode 键表中local wezterm require wezterm local act wezterm.action return { key_tables { copy_mode { -- v进入按单元格选择模式设置起点 { key v, mods NONE, action act.CopyMode { SetSelectionMode Cell } }, -- V进入按行选择模式 { key V, mods SHIFT, action act.CopyMode { SetSelectionMode Line } }, -- y复制到剪贴板 主选择清空选区但留在复制模式 { key y, mods NONE, action act.Multiple { act.CopyTo ClipboardAndPrimarySelection, act.ClearSelection, act.CopyMode { ClearSelectionMode }, }, }, -- Escape退出复制模式并回到滚动底端等价于默认键表的关闭行为 { key Escape, mods NONE, action act.Multiple { { CopyMode ScrollToBottom }, { CopyMode Close }, }, }, }, }, }这里SetSelectionMode负责建立选区起点start为None时会把当前光标位置记录为起点并调用select_to_cursor_pos()立即展开选区ClearSelectionMode负责拆除选区。二者的语义边界非常清晰可以从SetSelectionMode(None)与ClearSelectionMode在枚举中的并列关系以及 copy.rs 的set_selection_mode实现None self.clear_selection_mode()得到印证——即SetSelectionMode None在效果上等价于调用ClearSelectionMode。使用场景小结Vim 式 yank复制后选区消失光标原地保留可连续多次选择复制无需反复进出 CopyModeBlock/Line 选区预览后放弃误入选择模式、想取消高亮但继续浏览滚动缓冲时可用它反悔而不丢失当前位置与搜索NextMatch/PriorMatch联用清除残留选区后再移动匹配项避免高亮干扰视线自建键表的对称设计任何给SetSelectionMode分配了键位的键表都应考虑给ClearSelectionMode留一个对应入口保持操作的对称性。版本说明与兼容性ClearSelectionMode自版本20220807-113146-c2fee766起可用原文档中的{{since(20220807-113146-c2fee766)}}即指此版本。仓库 changelog.md 明确记载了它的引入wezterm.action.CopyMode(ClearSelectionMode)允许在不离开 Copy Mode 的情况下清除选择模式由 aznhe21 贡献对应讨论/PR #2352。同期还调整了SetSelectionMode的行为——对已激活的同一模式再次设置会被视为切换清除见 changelog.md。如果你的 WezTerm 版本低于上述版本号请先升级再使用该动作。延伸阅读SetSelectionMode与ClearSelectionMode配对的正向动作定义五种选择扩展模式默认 CopyMode 键表开箱即用的完整键位布局可作为自建键表的起点Copy Mode 完整指南CopyMode 的进入方式、搜索、跳转与完整操作说明Shell IntegrationSemanticZone选择模式所依赖的语义区域标记协议config/src/keyassignment.rs 与 wezterm-gui/src/overlay/copy.rs动作枚举定义与 GUI 端实现源码。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
WezTerm CopyMode 详解用ClearSelectionMode清除选择而不退出复制模式【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/weztermClearSelectionMode是 WezTerm 中 CopyMode复制模式的一个键盘动作KeyAssignment用于在不退出复制模式的前提下清除当前已激活的文本选择状态。它通常与CopyTo、ClearSelection等动作组合使用实现复制后自动清空高亮选择、光标仍停留在原位置的 Vim 式 yank 工作流。本文基于当前仓库的 ClearSelectionMode.md 文档结合源码实现完整讲解其语义、配置方法、底层原理与实战组合。CopyMode 与选择模式的概念在 WezTerm 中CopyMode 是一个叠加在终端之上的键盘操作模式允许用户脱离鼠标用键盘在回滚缓冲区scrollback中移动光标、建立选区并复制文本。进入 CopyMode 后默认键位见 默认键表提供了移动、翻页、跳转、搜索等一系列操作而**选择模式selection mode**则是其中负责如何扩展选区的子状态Cell按单元格单个字符逐格扩展选区Word按单词扩展选区Line按整行扩展选区Block以起点和当前光标位置为对角定义一个矩形区块SemanticZone扩展到当前语义区域依赖 Shell Integration。这些模式由SetSelectionMode动作设定详见 SetSelectionMode.md而ClearSelectionMode则扮演其逆操作把当前处于激活状态的选区撤销让终端回到 CopyMode 下无选区的干净状态。ClearSelectionMode的语义与典型行为根据原文档ClearSelectionMode的核心行为只有一句话清除当前的 CopyMode 选择模式但不会离开 CopyMode。与之对比CopyMode Close会直接退出复制模式回到正常终端而ClearSelectionMode只做撤销选择这一件事光标与复制模式上下文全部保留。这一语义在源码中体现得十分精确。在 config/src/keyassignment.rs 的CopyModeAssignment枚举中ClearSelectionMode与SetSelectionMode(OptionSelectionMode)是并列的两个变体pub enum CopyModeAssignment { MoveToViewportBottom, MoveToViewportTop, // ... SetSelectionMode(OptionSelectionMode), ClearSelectionMode, // ... }而 GUI 端在 wezterm-gui/src/overlay/copy.rs 的perform_assignment分发逻辑中把它直接路由到渲染器的clear_selection_mode()SetSelectionMode(mode) render.set_selection_mode(mode), ClearSelectionMode render.clear_selection_mode(),源码级的实现原理它到底清除了什么clear_selection_mode()的实际实现位于 wezterm-gui/src/overlay/copy.rs只有两行但每一行都对应一个关键状态fn clear_selection_mode(mut self) { self.start.take(); self.clear_selection(); }self.start.take()清除 CopyOverlay 内部记录的选择起点坐标start: OptionSelectionCoordinate。没有起点后续的select_to_cursor_pos()等选区扩展逻辑就无法再建立选区。self.clear_selection()通过TermWindowNotif::Apply向主窗口发送通知将对应 pane 的selection.origin与selection.range一并取走见 copy.rs从而让终端界面上的高亮选区立刻消失。也就是说清除选择模式在底层同时做了两件事清掉选区锚点start并清掉渲染层的高亮范围origin/range。值得留意的是它不会触碰光标位置也不会修改selection_mode本身——下次用SetSelectionMode重新选择时仍会沿用之前的模式设定Cell/Word/Line/Block 等。这一点与SetSelectionMode的同模式再次设置即切换清除行为见 copy.rs形成互补前者是显式清除后者是隐式切换。实战配置y键 yank 后清除选择且留在复制模式原文档给出的核心示例是在copy_mode键表中把y绑定为复制到主选择 → 清空选择状态 → 清除选择模式但不退出复制模式。这是最典型的应用场景——Vim 用户按下yyank后既希望文本已复制又不希望选区高亮还悬在屏幕上同时还想继续留在复制模式进行下一次移动与选择。local wezterm require wezterm local act wezterm.action return { key_tables { copy_mode { { key y, mods NONE, action act.Multiple { act.CopyTo PrimarySelection, act.ClearSelection, -- clear the selection mode, but remain in copy mode act.CopyMode { ClearSelectionMode }, }, }, }, }, }下面对这个配置逐项拆解方便读者按需增删key y、mods NONE指定裸按y触发不带 Shift/Ctrl/Alt 修饰键。注意键表在key_tables.copy_mode下定义因此只有处于 CopyMode 时该绑定才生效。act.CopyTo PrimarySelection把当前选区内容复制到主选择Primary Selection对应 X11/Wayland 的鼠标中键粘贴缓冲。若你更习惯剪贴板CtrlV 粘贴可换成act.CopyTo Clipboard或act.CopyTo ClipboardAndPrimarySelection。act.ClearSelection清空底层 pane 的选区状态。act.CopyMode { ClearSelectionMode }显式调用清除选择模式动作。由于它不会关闭 CopyMode本次y操作结束后你依然停留在复制模式中可以立即继续移动光标做下一次选择。act.Multiple { ... }把上述多个动作按顺序合并成一次按键触发保证先复制、再清空的执行顺序。如果不希望停留在复制模式、而是复制完直接回到终端可以对比默认键表中y的既有定义——默认行为是复制到ClipboardAndPrimarySelection后执行ScrollToBottom与Close见 默认 CopyMode 键表。两种风格可以并存或按个人习惯替换ClearSelectionMode的价值正在于补上了只清选区、不退模式这一中间选项。与SetSelectionMode的配合完整的选择循环ClearSelectionMode通常与SetSelectionMode成对出现形成完整的开始选择 → 移动扩展 → 复制 → 清除选区循环。例如在 copy_mode 键表中local wezterm require wezterm local act wezterm.action return { key_tables { copy_mode { -- v进入按单元格选择模式设置起点 { key v, mods NONE, action act.CopyMode { SetSelectionMode Cell } }, -- V进入按行选择模式 { key V, mods SHIFT, action act.CopyMode { SetSelectionMode Line } }, -- y复制到剪贴板 主选择清空选区但留在复制模式 { key y, mods NONE, action act.Multiple { act.CopyTo ClipboardAndPrimarySelection, act.ClearSelection, act.CopyMode { ClearSelectionMode }, }, }, -- Escape退出复制模式并回到滚动底端等价于默认键表的关闭行为 { key Escape, mods NONE, action act.Multiple { { CopyMode ScrollToBottom }, { CopyMode Close }, }, }, }, }, }这里SetSelectionMode负责建立选区起点start为None时会把当前光标位置记录为起点并调用select_to_cursor_pos()立即展开选区ClearSelectionMode负责拆除选区。二者的语义边界非常清晰可以从SetSelectionMode(None)与ClearSelectionMode在枚举中的并列关系以及 copy.rs 的set_selection_mode实现None self.clear_selection_mode()得到印证——即SetSelectionMode None在效果上等价于调用ClearSelectionMode。使用场景小结Vim 式 yank复制后选区消失光标原地保留可连续多次选择复制无需反复进出 CopyModeBlock/Line 选区预览后放弃误入选择模式、想取消高亮但继续浏览滚动缓冲时可用它反悔而不丢失当前位置与搜索NextMatch/PriorMatch联用清除残留选区后再移动匹配项避免高亮干扰视线自建键表的对称设计任何给SetSelectionMode分配了键位的键表都应考虑给ClearSelectionMode留一个对应入口保持操作的对称性。版本说明与兼容性ClearSelectionMode自版本20220807-113146-c2fee766起可用原文档中的{{since(20220807-113146-c2fee766)}}即指此版本。仓库 changelog.md 明确记载了它的引入wezterm.action.CopyMode(ClearSelectionMode)允许在不离开 Copy Mode 的情况下清除选择模式由 aznhe21 贡献对应讨论/PR #2352。同期还调整了SetSelectionMode的行为——对已激活的同一模式再次设置会被视为切换清除见 changelog.md。如果你的 WezTerm 版本低于上述版本号请先升级再使用该动作。延伸阅读SetSelectionMode与ClearSelectionMode配对的正向动作定义五种选择扩展模式默认 CopyMode 键表开箱即用的完整键位布局可作为自建键表的起点Copy Mode 完整指南CopyMode 的进入方式、搜索、跳转与完整操作说明Shell IntegrationSemanticZone选择模式所依赖的语义区域标记协议config/src/keyassignment.rs 与 wezterm-gui/src/overlay/copy.rs动作枚举定义与 GUI 端实现源码。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
