MICROSOFT

EP06. “Macro Comments 宏注释”

首页 Microsoft 工具 Excel · VBA · Macro Errors · EP06
约 3 分钟· #EP06#Excel#Macro Errors
🔒 登录后可标记已读
  • 三个月后回头看自己写的宏,常常一脸问号「这段到底在干嘛」——注释就是留给未来自己的说明书
  • 单行注释很简单:在那行最前面打一个单引号 ',整行变绿,跟能跑的代码分开
  • 想一次注释/取消注释一大段,不用一行行手动打,Edit 工具栏有 Comment Block / Uncomment Block 按钮
  • 学完能养成随手写注释的习惯,代码规模越大越看得出差别

重点内容


适用版本

桌面版通用(Excel 365 / 2021 / 2019 等)。


加注释

  1. 打开 VBA 编辑器
  2. 在想加说明的那一行前面打一个单引号 '

加了单引号的整行会变成绿色,跟可执行的代码用颜色区分开来。例如:

' 这段代码把 A1:E20 填满 20 到 100 之间的随机数字

[截图:VBA 编辑器里,加了单引号的注释行显示成绿色文字,跟其他黑色代码明显区分]


批量注释/取消注释多行

  1. View → Toolbars → Edit,显示 Edit 工具栏
  2. 选中要处理的那几行代码
  3. 点击 Comment Block 按钮,一次替所有选中行加上单引号
  4. 想取消注释,改选中后点击旁边的 Uncomment Block 按钮

[截图:VBA 编辑器的 Edit 工具栏,Comment Block 和 Uncomment Block 两个按钮的位置]


方法怎么选

方法适合场景备注
手动打 '只想注释一行打在这行最前面即可
Comment Block 按钮想一次注释/取消注释一大段先在 View → Toolbars → Edit 叫出 Edit 工具栏

学完你会

  • ✅ 用单引号 ' 给单行代码加注释
  • ✅ 用 Comment Block / Uncomment Block 按钮批量处理多行
  • ✅ 养成写注释的习惯,方便自己和别人回头看懂代码

常见错误

  • 代码量大却完全不写注释,回头自己都看不懂当初为什么这样写
  • 想批量注释一大段代码,却一行一行手动加单引号,忘了 Edit 工具栏有 Comment Block 按钮
  • 调试时用注释暂时「关掉」某几行代码,测完忘记取消注释,正式版本少跑了这几行

Sources

Blog / Website:

  1. Macro Comments