
在 VBA 编程中,注释是对代码功能、逻辑或意图的文字性说明。程序执行时会自动忽略所有注释内容,因此注释不会对运行效率或结果产生任何影响。
VBA 中的注释以英文单引号 ' 作为起始符号,其后所写的所有文字均被视为注释文本。标准格式如下:
'这里是注释内容
下面通过具体示例来理解注释的实际应用方式。
单行注释可独立成行,即整行仅包含注释信息,从单引号开始直到行末均为注释内容。
Sub MyCode()
'声明一个用于存储姓名的字符串变量
Dim name As String
End Sub注释也可紧跟在某条语句之后,位于同一行内,此时单引号及其右侧内容全部被识别为注释。
Sub MyCode()
'声明一个用于存储姓名的字符串变量
Dim name As String
name = Range("A1").Value '获取工作表中 A1 单元格的值并赋给变量 name
End Sub若需添加多行注释,则每一行都必须以单引号开头。
'该子过程的主要功能是从指定单元格读取数据
'最后修改日期:2018-12-13
'编写者:懒人Excel
Sub MyCode()
'定义一个字符串类型的变量 name
Dim name As String
name = Range("A1").Value '从 A1 单元格提取姓名信息
End Sub注释的作用
最基础的功能是辅助理解代码,例如:
- 描述某个过程或函数的设计目的与使用场景;
- 明确变量的含义及作用范围;
- 阐述特定算法或实现方式的选择理由;
- 标识不同功能模块之间的边界
此外,在开发与调试阶段,常通过添加单引号将部分代码临时“屏蔽”,使其不参与运行,从而快速定位问题所在。
小结
注释虽不参与程序执行,却是高质量代码不可或缺的重要组成部分。
强烈建议开发者在编写 VBA 代码时同步添加清晰、准确的注释。因为在实际项目中,代码往往涉及大量变量、嵌套结构和复杂逻辑,稍有疏忽就容易混淆上下文,导致排查耗时;更不必说日后维护或交由他人接手时,良好的注释能极大提升可读性与协作效率。

















