GO 语言的注释 | 学习笔记

简介: 快速学习 GO 语言的注释

开发者学堂课程【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张飞")

}

② 在没有注释时,运行结果如下:

图片7.png

如果想要注释,只需在代码前加两个斜杠//即可。将其中三行代码注释

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 \“”)

*/

相关文章
|
9天前
|
存储 Go 索引
go语言中数组和切片
go语言中数组和切片
22 7
|
9天前
|
Go 开发工具
百炼-千问模型通过openai接口构建assistant 等 go语言
由于阿里百炼平台通义千问大模型没有完善的go语言兼容openapi示例,并且官方答复assistant是不兼容openapi sdk的。 实际使用中发现是能够支持的,所以自己写了一个demo test示例,给大家做一个参考。
|
9天前
|
程序员 Go
go语言中结构体(Struct)
go语言中结构体(Struct)
86 71
|
8天前
|
存储 Go 索引
go语言中的数组(Array)
go语言中的数组(Array)
93 67
|
9天前
|
存储 Go
go语言中映射
go语言中映射
27 11
|
11天前
|
Go
go语言for遍历映射(map)
go语言for遍历映射(map)
25 12
|
10天前
|
Go 索引
go语言使用索引遍历
go语言使用索引遍历
19 9
|
10天前
|
Go 索引
go语言使用range关键字
go语言使用range关键字
18 7
|
11天前
|
Go
go语言for 遍历字符串
go语言for 遍历字符串
23 8
|
10天前
|
Go 索引
go语言修改元素
go语言修改元素
20 6