开发者学堂课程【Go 语言核心编程 - 基础语法、数组、切片、Map: GO 语言的注释】学习笔记,与课程紧密联系,让用户快速学习知识。
课程地址:https://developer.aliyun.com/learning/course/625/detail/9504
GO 语言的注释
内容介绍
一、注释的介绍
二、Go 语言中的注释类型
一、注释的介绍:
注释( comment )
用于注解说明解释程序的文字就是注释,注释提高了代码的阅读性;同时在长时间之后也方便再次阅读代码,因而注释是一个程序员必须要具有的良好编程习惯。
将自己的思想通过注释先整理出来,再用代码去体现。同时轻松他人阅读自己的代码。
举例:
我们任意打开 go 文件夹下的 scr 中任意一个源代码,其中就有//后的即为代码的注释,如其中// write is the function to call to emit formatted putput to be printed
就表示写一个函数去调用其输出,因而说明代码注释的重要。
二、Go 语言中的注释类型
Go 支持 c 语言风格的/**/块注释,也支持 C++ 风格的//行注释。行注释更通用,块注释主要用于针对包的详细说明或者屏藏大块的代码。
1. 行注释
(1) 基本语法
//注释文字
(2) 应用实例
① 代码:
package main
import "fmt”
// fmt 表示格式化的包,包中提供格式化,输出,输入的函数
func main() {
//演示转义字符的使用 \ t
fmt.Println("tomtjack")
fmt.Println( "hello\nworld")
// \ n 表示换行输出
fmt.Println("c: \\users\\Administrator\\Desktop\\Go语言核心编程课程\\资料")
fmt.Println( "tom说\"i love you\"")
fmt.Println("天龙八部雪山飞狐\r张飞")
}
② 在没有注释时,运行结果如下:
如果想要注释,只需在代码前加两个斜杠//即可。将其中三行代码注释
package main
import "fmt”
// fmt 表示格式化的包,包中提供格式化,输出,输入的函数
func main() {
//演示转义字符的使用 \ t
//fmt.Println("tomtjack")
//fmt.Println( "hello\nworld")
// \n表示换行输出
//fmt.Println("c: \\users\\Administrator\\Desktop\\Go语言核心编程课程\\资料")
fmt.Println( "tom说\"i love you\"")
fmt.Println("天龙八部雪山飞狐\r张飞")
}
③ 注释后,运行结果如下:
只出现了未被注释的文字,说明注释之后代码不再被编译运行输出.同时还可以使用快捷键,并在函数之前添加文字说明。
(3)快捷键
如果希望一次性注释,全选内容 ctr+/ 可一键注释
同时第一次表示注释,第二次表示取消注释
2.块注释(多行注释)
(1) 基本格式
格式:/*注释文字*/
(2) 应用实例
按照行注释的案例,如想要注释下面三行代码,也可使用块注释/*注释文字*/也可一键进行注释。
package main
import "fmt”
// fmt 表示格式化的包,包中提供格式化,输出,输入的函数
func main() {
//演示转义字符的使用 \ t
/*fmt.Println("tomtjack")
fmt.Println( "hello\nworld")
// \n 表示换行输出
fmt.Println("c: \\users\\Administrator\\Desktop\\Go语言核心编程课程\\资料")
*/
fmt.Println( "tom说\"i love you\"")
fmt.Println("天龙八部雪山飞狐\r张飞")
}
3.使用细节
1)对于行注释和块注释,被注释的文字,不会被 Go 编译器解释执行。
2)块注释里面不允许有块注释嵌套【注意一下】
举例:
假设我们要在这此块注释中再添加块注释
//如果希望一次性注释 ctrl+/ 第一次表示注释,第二次表示取消注释
/*
fmt.Println("tomtjack")
fmt.Println( "hello\nworld")
// \n表示换行输出
fmt.Println("c: \\users\\Administrator\\Desktop\\Go语言核心编程课程\\资料")
Fmt.println(“tom说\“i love you \“”)
*/
在原来的块注释中再次添加块注释时,就会显示报错,因为块注释里面不允许再嵌套块注释,因为块注释从/*开始在遇到*/就结束。下方多余的*/找不到对应的/*无法被识别。
/*
fmt.Println("tomtjack")
/*fmt.Println( "hello\nworld")
// \n表示换行输出
fmt.Println("c: \\users\\Administrator\\Desktop\\Go语言核心编程课程\\资料")*/
Fmt.println(“tom说\“i love you \“”)
*/