当前位置：网站首页>＃yyds干货盘点＃【愚公系列】2022年08月 Go教学课程 004-Go代码注释

＃yyds干货盘点＃【愚公系列】2022年08月 Go教学课程 004-Go代码注释

2022-08-07 07:52:00 【51CTO】

前言

1.注释的定义

注释就是对代码的解释和说明。目的是为了让别人和自己很容易看懂，一看就知道这段代码是做什么用的。正确的程序注释一般包括序言性注释和功能性注释。序言性注释的主要内容包括模块的接口、数据的描述和模块的功能。模块的功能性注释的主要内容包括程序段的功能、语句的功能和数据的状态。

2.注释的作用

注释只是为了提高可读性，不会被计算机编译。

一、Go代码注释

Go语言的注释主要分成两类，分别是单行注释和多行注释。

1.单行注释

单行注释简称行注释，是最常见的注释形式，可以在任何地方使用以//开头的单行注释；

快捷键：ctrl+c

// Add 两数相加（这一行会被截取为简短介绍）
// 两数相加的注意事项以及原理（这一行作为超级详细的介绍）
func Add(n1,n2 int)int{
    return n1+n2
}

     1.
2.
3.
4.
5.

2.多行注释

多行注释简称块注释，以/*开头，并以*/结尾，且不可以嵌套使用，多行注释一般用于包的文档描述或注释成块的代码片段。

快捷键：shift+ctrl+c

/* regexp 包为正则表达式实现了一个简单的库。 该库接受的正则表达式语法为： regexp: concatenation { '|' concatenation } concatenation: { closure } closure: term [ '*' | '+' | '?' ] term: '^' '$' '.' character '[' [ '^' ] character-ranges ']' '(' regexp ')' */
package regexp

     
      1.
      2.
      3.
      4.
      5.
      6.
      7.
      8.
      9.
      10.
      11.
      12.
      13.
      14.
      15.
      16.
      17.
      18.
      19.
      20.