Excel VBA中Application.OnKey绑定过程需置于模块的原因及文档依据

核心底层逻辑 #

Application.OnKey 绑定的过程必须存放在标准模块，是VBA作用域规则和OnKey本身的运行层级共同决定的：

• 首先，工作表代码区、ThisWorkbook代码区本质是绑定到特定文档对象的类模块，而非全局可访问的标准模块。这类模块中声明的Public过程，并不是工程级全局过程，必须依托对应对象的实例才能调用——比如写在Sheet1模块里的Test过程，合法调用方式是Sheet1.Test，无法直接通过过程名Test在全局范围调用。
• 其次，Application.OnKey是Excel应用层级的全局快捷键钩子，运行在Excel进程的全局消息循环层面，触发回调时不会绑定到任何特定的工作表、工作簿对象实例，它的过程查找逻辑只会扫描全局命名空间下、直接挂载在标准模块上的公共过程，不会主动遍历所有文档类模块的实例成员。哪怕你在Procedure参数里写全类模块的限定路径（比如Sheet1.ClearFormatting），OnKey的内置解析器也无法识别，最终会抛出“无法运行指定宏”的错误。
• 补充一个验证点：除了OnKey，其他应用层级的回调注册方法（比如Application.OnTime、自定义功能区按钮的回调）都遵循完全相同的规则，只认标准模块中的全局公共过程。

官方文档相关说明 #

目前微软公开的Excel VBA官方文档中，确实没有在Application.OnKey方法的专属说明页明确列出该部署要求，属于文档遗漏。相关规则仅零散分布在VBA语言规范的两类描述中：

1. 标准模块中的公共过程属于工程级全局成员，可直接通过过程名在工程任意位置调用；类模块（含文档类模块、窗体模块、自定义类模块）中的公共过程属于类实例成员，必须依托类实例才可访问。
2. Application.OnKey方法的Procedure参数要求传入可在全局上下文直接调用的过程名称字符串。

正确写法示例 #

按键绑定代码无论写在工作表、ThisWorkbook还是标准模块中，只要指向标准模块内的公共过程即可正常生效：

' 按键绑定语句示例
Application.OnKey Key:="{BS}", Procedure:="ClearCell.ClearFormatting"

对应的回调过程必须放在标准模块（示例中为名为ClearCell的标准模块）中：

Option Explicit

Public Sub ClearFormatting()
  With Application.ActiveCell
    ' 自定义业务逻辑，比如清除活动单元格格式
  End With
End Sub

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