EP01. “Option Explicit 强制声明变量”

• Option Explicit 写在 VBA 代码最上方，强制要求所有变量都要先声明才能用
• 这篇讲它能拦下什么错误、怎么在写代码前手动加、怎么设置成以后自动加
• 前置知识：基本的变量声明（Dim）
• 学完能避免打错变量名却完全不报错的坑

重点内容

适用版本

桌面版通用（Excel 365 / 2021 / 2019 等）。

没有 Option Explicit 会发生什么

Dim myVar As Integer
myVar = 10
Range("A1").Value = mVar

加上 Option Explicit 之后

在模块最上方加一行：

Option Explicit

再执行同一段代码，VBA 会直接报错「Variable not defined」，卡在 mVar 那一行，逼你发现并修正打错字的问题。

[截图：VBA 编辑器弹出的 "Variable not defined" 报错对话框，代码窗口里出错的 mVar 那一行被黄色高亮标示]

设置成以后自动加

1. 打开 VBA 编辑器（Visual Basic Editor）
2. Tools → Options
3. 勾选 Require Variable Declaration（要求变量声明）

[截图：VBA 编辑器 Tools → Options 窗口的 Editor 标签，Require Variable Declaration 勾选框位置]

学完你会

• ✅ 在模块最上方加 Option Explicit，逼 VBA 抓出未声明的变量
• ✅ 设置 Require Variable Declaration，让新建模块自动加上 Option Explicit
• ✅ 看懂「变量名打错却不报错」这种坑是怎么发生的，学会避开

常见错误

• 以为设置了 Require Variable Declaration 后，旧文件也会自动加上 Option Explicit，其实旧文件要手动补
• 变量名打错却没加 Option Explicit，VBA 不报错，默默用一个空变量继续跑，很难排查
• Option Explicit 一定要放在模块最上方（所有程序代码之前），放错位置不会生效

Sources

Blog / Website：

1. Option Explicit