【新手入门】第 8 讲：注释的五种写法

xLeaves（xxrpa）发布于 2022年05月27日 21:04:20

当我们的代码越写越多的时候，所有的代码堆积在一起，隔一段时间不看这些代码，再去研读就容易头昏脑涨的。

看不懂之前到底是怎么写出来这一大坨屎山的。

如果我们能在写代码的时候，在代码中留下一些关于这堆代码是干什么的备注，则未来再阅读这段代码的时候，思路就会清晰很多。

在代码中留下一些存在但不会执行的东西，这种代码就叫注释。

第一种：Rem注释

这是老BASIC语言使用的注释方式，目前已经很少使用了，不推荐。

Function Main() As Long
	TracePrint("第一行代码")	Rem 这样写注释也可以
	Rem 第二行代码
	TracePrint("第三行代码")
End Function

写法为：Rem 后面的内容不会执行，仅限当前行。

第二种：BASIC风格的单行注释

写的代码为了尽量贴合BASIC语系习惯的时候，推荐使用这种写法。

Function Main() As Long
	TracePrint("第一行代码")	' 这样写注释也可以
	' 第二行代码
	TracePrint("第三行代码")End Function

写法为：半角单引号【 ' 】后面的内容不会执行，仅限当前行。

第三种：C语言风格的单行注释

这是一种比较新潮的写法，通常情况下是最建议使用的单行注释方式。

Function Main() As Long
	TracePrint("第一行代码")	// 这样写注释也可以
	// 第二行代码
	TracePrint("第三行代码")
End Function

写法为：两条斜杠【 // 】后面的内容不会执行，仅限当前行。

第四种：C语言风格的多行注释

一些比较复杂的注释需要用好几行才能描述清楚，这时候使用多行注释会非常方便。

Function Main() As Long
	TracePrint("第一行代码")	/* 这样写注释也可以 */
	/*
		第二行代码
	*/
	TracePrint("第三行代码")
End Function

写法为：以【 /* 】开始，以【 */ 】结束，中间的部分全都是注释，多行注释也可以写为单行。

第五种：屏蔽代码的快捷注释

有时候我们写注释不一定真的是为了注释，也可能是屏蔽一部分代码，让他们无法运行。

屏蔽单行代码我们可以用前几种单行注释，但屏蔽多行代码用单行注释就很不方便了，可以用多行注释。

有时候我们需要反复测试一段或几段代码，就需要反复注释、取消注释代码，这时候可以用这种写法，更快捷的注释和取消注释：

Function Main() As Long
	/* 注释状态
	MsgBox("我会执行吗，第一块代码？")
	MsgBox("我会执行吗，第一块代码？")
	MsgBox("我会执行吗，第一块代码？")
	//*/
	
	//* 取消注释状态
	MsgBox("我会执行吗，第二块代码？")
	MsgBox("我会执行吗，第二块代码？")
	MsgBox("我会执行吗，第二块代码？")
	//*/
End Function

注意注释状态和取消注释状态的区别，只需要编辑一个字符，就可以快速更改注释状态了，是不是很方便？

在取消注释状态，实际上块注释被两个单行注释给注释掉了，就构成了这样的使用技巧。