在 Ace 编辑器中，仅靠 event.preventDefault() 和 event.stopPropagation() 无法阻止后续默认行为；必须通过键盘处理器（KeyHandler）返回特定对象（如 {command: "null"}）显式告知 Ace 停止事件分发。
在 ace 编辑器中，仅靠 `event.preventdefault()` 和 `event.stoppropagation()` 无法阻止后续默认行为；必须通过键盘处理器（keyhandler）返回特定对象（如 `{command: "null"}`）显式告知 ace 停止事件分发。
Ace 编辑器的键盘事件处理机制高度结构化：它不依赖原生 DOM 事件流的中断逻辑（如 stopPropagation），而是基于命令式调度模型——每个 KeyHandler 的职责是声明“该触发哪个命令”，而非直接操作编辑器状态。因此，即使你在回调中调用了 moveCursorTo 并阻止了原生事件，Ace 仍会继续查找并执行匹配的内置命令（例如 alt-up 默认可能触发行上移），导致行为冲突。
✅ 正确做法：返回 {command: "null"} 终止处理链
当你的 KeyHandler 已完成全部逻辑（如光标跳转、自定义导航），应明确返回 {command: "null"}，这是 Ace 内部约定的“终止信号”。该对象会令编辑器跳过后续所有 KeyHandler 和默认命令绑定：
private fun keyHandler(data: String, hash: String, keyString: String, keyCode: Int, event: KeyboardEvent?): Boolean {
return when {
event?.altKey == true && event.keyCode == 36 -> {
aceEditor?.moveCursorTo(0, 0)
mapOf("command" to "null") // ✅ 关键：终止后续处理
}
event?.altKey == true && event.keyCode == 35 -> {
val lineCount = aceEditor?.getValue()?.split("\n")?.size ?: 1
aceEditor?.moveCursorTo(lineCount - 1, 0)
mapOf("command" to "null")
}
event?.altKey == true && event.keyCode == 38 -> {
moveNextOrPrev(false)
mapOf("command" to "null")
}
else -> null // 返回 null 表示不处理，交由后续 handler 或默认命令
} != null
}
⚠️ 注意：
return true在旧版 Ace 中可能被误判为“已处理但需继续执行默认命令”，而return {command: "null"}是唯一被官方文档和源码（keybinding.js#L107）明确定义的终止方式。
? 更推荐方案：使用 addCommand + bindKey（符合 Ace 设计哲学）
若逻辑可封装为独立操作，应优先采用命令模式——它天然支持撤销栈合并、宏录制、多选适配等高级特性：
// 1. 注册自定义命令
aceEditor?.commands?.addCommand(mapOf(
"name" to "gotoTop",
"bindKey" to "Alt-Home",
"exec" to { editor -> editor.moveCursorTo(0, 0) }
))
aceEditor?.commands?.addCommand(mapOf(
"name" to "gotoBottom",
"bindKey" to "Alt-End",
"exec" to { editor ->
val lineCount = editor.getValue().split("\n").size
editor.moveCursorTo(lineCount - 1, 0)
}
))
// 2. Alt-Up/Down 同理注册（无需手动监听 keyCode）
aceEditor?.commands?.addCommand(mapOf(
"name" to "movePrevItem",
"bindKey" to "Alt-Up",
"exec" to { _ -> moveNextOrPrev(false) }
))
? 总结建议
-
避免在
KeyHandler中直接修改编辑器状态：这绕过 Ace 的状态管理机制，易引发撤销异常、多选错位等问题。 -
优先用
addCommand：适用于有明确语义的操作（如“跳转到顶部”），利于维护与扩展。 -
仅当需动态决策时用
KeyHandler：例如根据光标位置、语法模式切换行为，此时务必返回{command: "null"}终止链路。 -
切勿依赖
pos参数控制执行顺序：addKeyboardHandler(handler, pos)的pos仅影响 handler 注册顺序，不改变事件分发逻辑；终止行为必须由返回值驱动。
