VBA 变量作用域

在 VBA 中，变量的作用域决定了该变量在哪些位置可以被访问和使用。依据变量声明的位置及所用关键字，其作用域可分为以下三类：

1. 过程级作用域
2. 模块级作用域
3. 工程级作用域

接下来将分别说明各类作用域下变量的定义方式与调用规则。

在子过程（Sub）或函数（Function）内部通过 Dim 声明的变量，仅限于该过程内部使用。例如：

Sub Test()

    Dim name As String
    Dim age As Integer

    name = "张三"
    age = 35

End Sub

上述代码中，name 和 age 在 Test 过程内定义，因此只能在该过程中进行赋值或读取操作。若在其他过程或模块中尝试直接引用这两个变量，VBA 将报错：“变量未定义”。

2. 模块级作用域

在模块的通用声明区域（即所有过程之外），使用 Private 或 Dim 关键字声明的变量称为模块变量，其有效范围覆盖整个当前模块。例如：

Dim guest As String

Sub Test()

    Dim message As String

    guest = "张三"
    message = "你好"

    MsgBox message & "！ " & guest

End Sub

本例中，guest 变量位于 Test 过程外部，并以 Dim 方式声明，属于模块变量。它可在本模块内的任意过程或函数中被访问和修改。

需要说明的是：在模块顶部使用 Dim 或 Private 声明的变量具有相同的作用域效果，二者完全等价。如下两种写法功能一致：

Dim guest As String
Private guest As String

3. 工程级作用域

在 Excel VBA 环境中，一个工作簿对应一个完整的 VBA 工程。工程级变量可在当前工程的所有模块、工作表对象、ThisWorkbook 对象、用户窗体（UserForm）以及类模块（Class Module）中被共享使用。

要声明工程级变量，需满足两个条件：

• 所在模块顶部包含语句 Option Private Module（可选，但推荐用于明确工程级意图）；
• 在通用声明区使用 Public 关键字声明变量。

示例如下：

Option Private Module

Public guest As String

Sub Test()

    Dim message As String

    guest = "张三"
    message = "你好"

    MsgBox message & "！ " & guest

End Sub

此处 guest 使用 Public 声明，是典型的工程级变量，不仅能在本模块中使用，还可被同一工作簿中的其他模块、类模块或事件过程所调用。

作用域优先级（就近原则）

当同名变量在不同作用域中重复声明时，会发生作用域重叠现象。此时 VBA 采用就近原则（Local Scope Precedence） 来决定实际引用的对象——即优先选用距离当前代码最近的作用域中的变量定义。例如：

Dim name As String

Sub Test()

    Dim name As String

    name = "李四"

End Sub

该示例中，name 同时作为模块变量和过程变量存在。在 Test 过程内部执行 name = "李四" 时，系统自动绑定到过程内声明的 name，而非模块级的那个。模块级变量在此过程中不可见（除非显式加前缀如 ModuleName.name）。