Go语言注释的作用是什么
来源:亿速云
时间:2023-03-03 07:55:51 286浏览 收藏
在IT行业这个发展更新速度很快的行业,只有不停止的学习,才不会被行业所淘汰。如果你是Golang学习者,那么本文《Go语言注释的作用是什么》就很适合你!本篇内容主要包括Go语言注释的作用是什么,希望对大家的知识积累有所帮助,助力实战开发!
本篇内容主要讲解“Go语言注释的作用是什么”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“Go语言注释的作用是什么”吧!
注释在程序中的作用是对程序进行注解和说明,高程序代码的可读性,便于对源码的阅读;目的是为了让别人和自己很容易看懂,一看就知道这段代码是做什么用的。go的注释有行注释“//”和块注释“/* */”之分;在实际的使用中,行注释使用得比较多,块注释主要用于格式化大段代码或包的注释中使用。
注释有什么作用
注释就是对代码的解释和说明,其目的是让人们能够更加轻松地了解代码。注释是编写程序时,写程序的人给一个语句、程序段、函数等的解释或提示,能提高程序代码的可读性。
注释在程序中的作用是对程序进行注解和说明,便于对源码的阅读。编译系统在对源代码进行编译时会自动忽略注释的部分,因此注释对于程序的功能实现不起任何作用。在源码中适当地添加注释,能够提高源码的可读性。
注释就是对代码的解释和说明。目的是为了让别人和自己很容易看懂,一看就知道这段代码是做什么用的。正确的程序注释一般包括序言性注释和功能性注释。序言性注释的主要内容包括模块的接口、数据的描述和模块的功能。模块的功能性注释的主要内容包括程序段的功能、语句的功能和数据的状态。
go 注释的分类
go 的注释有行注释 //
和块注释 /* */
之分。在实际的使用中,行注释使用得比较多,块注释主要用于格式化大段代码或包的注释中使用。
在 goland 中行注释的快捷键为 Ctrl+/
, 块注释的快捷键为 Ctrl+Shift+/
应用
文件注释
在每个文件中前都加上一段注释,这段注释用来描述 作者,时间,以及版权。
我们可以随便打开一个包查看,如 builtin.go 包中
// Copyright 2011 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
就有时间 2011, 作者 go,和版权,我们可以随便打开其他文件,可以发现只有时间在变,而其他都没有变化。
在 goland 中可以在 Settings/Editor/File and Code Templates/Files/Go File
中寻改文件注释模板,这样每次新建文件都会自动生成注释。
这是我的模板
//@program: ${PROJECT_NAME}
//@author: edte
//@create: ${YEAR}-${MONTH}-${DAY} ${HOUR}:${MINUTE}
package ${GO_PACKAGE_NAME}
包注释
包注释用来描述介绍这个包,以及提供包的一些信息。
在 go 中,一个 目录中只有一个包(不包扩子目录),所以一个包中可以有多个文件,一般在其中一个文件写上包注释即可。
同样的,我们来看 builtin 这个包 中的 builtin.go 文件
/*
Package builtin provides documentation for Go's predeclared identifiers.
The items documented here are not actually in package builtin
but their descriptions here allow godoc to present documentation
for the language's special identifiers.
*/
可以看到 builtin 包的作用是给预定义标识符提供文档。
我们同样来看 errors 包中的 errors.go 文件,可以看到包注释很长
// Package errors implements functions to manipulate errors.
这里讲了包 errors 实现了一些处理错误的功能。
// The New function creates errors whose only content is a text message.
//
// The Unwrap, Is and As functions work on errors that may wrap other errors.
后面还有一大堆,讲了 errors 包相关的文件,原理,应用等信息。
如果我们继续查看源码,会发现包注释都是以 package + 一个动词
开头的,一般这个短句就说明了这个包的功能,然后再视具体的包说明包的其他信息。
函数注释
函数注释用来描述函数的功能,以及其他相关的信息。
我们同样来看 errros 包中的 errors.go 文件
// New returns an error that formats as the given text.
// Each call to New returns a distinct error value even if the text is identical.
func New(text string) error {
return &errorString{text}
}
这里用一句话说明了 New 功能的作用,即返回一个自定义的错误。
然后又用一句话说了这个函数相关的特点,即使文本相同,每次对 New 的调用也会返回一个不同的错误值。
如果同样查看其他源码中的函数,我们发现一般几乎都是 函数名 + 一个动词
的句子开头。这个句子同样说明了这个函数的作用,即函数干了些什么。
而其他需要讲解的信息则以复杂度为基础,如果感觉某个点不容易理解,那么最好都要写注释,如函数签名,函数原理,函数使用过程中需要注意的点等。
数据类型注释
数据类型注释说明 这个数据类型用来干什么。
如 errors.go 中
// errorString is a trivial implementation of error.
type errorString struct {
s string
}
这里就说明了 errorString 的作用,即 error 的具体实现。
如 built.go 中
// bool is the set of boolean values, true and false.
type bool bool
// true and false are the two untyped boolean values.
const (
true = 0 == 0 // Untyped bool.
false = 0 != 0 // Untyped bool.
)
// The error built-in interface type is the conventional interface for
// representing an error condition, with the nil value representing no error.
type error interface {
Error() string
}
几乎都是以 类型名 + is
开头的句子,这个句子说明了这个类型的作用。
TODO
TODO 即 to do, 是一个特殊的注释,表明在此处有功能等待编写。
FIXME
FIXME 即 fix me, 也是一个特殊的注释,表明此处的功能需要修正,甚至不能运行。
XXX
XXX 也是一个特殊的注释,表明此处的功能实现方法有点问题,需要更改。
godoc
godoc 是一个实用的工具,可以根据特定的注释格式生成文档。也可以用来查看文档,同样的 go doc 命令也是相似的作用。
到此,相信大家对“Go语言注释的作用是什么”有了更深的了解,不妨来实际操作一番吧!这里是golang学习网,更多相关内容可以进入相关频道进行查询,关注我们,继续学习!
文中关于golang的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《Go语言注释的作用是什么》文章吧,也可关注golang学习网公众号了解相关技术文章。
-
185 收藏
-
460 收藏
-
430 收藏
-
450 收藏
-
320 收藏
-
309 收藏
-
225 收藏
-
485 收藏
-
233 收藏
-
322 收藏
-
181 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 507次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 497次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习