ToB企服应用市场:ToB评测及商务社交产业平台

标题: 3、Go中的注释 [打印本页]
作者: 美丽的神话    时间: 2025-1-12 08:45
标题: 3、Go中的注释
1、注释的作用

在前面我们已经写过第一个GO步伐了，该步伐的功能很简单，代码量不是许多，也就是几行代码。
但是大家看下面这段代码，代码量比我们写的第一个步伐代码量多了许多，代码多了以后，阅读起来非常不容易。
  1. package main  
  2.   
  3. import "fmt"  
  4.   
  5. func binarySearch(arr []int, target int) int {  
  6.   
  7.     left, right := 0, len(arr)-1  
  8.   
  9.     for left <= right {  
  10.        mid := left + (right-left)/2  
  11.   
  12.        if arr[mid] == target {  
  13.           return mid  
  14.        }  
  15.   
  16.        if arr[mid] < target {  
  17.           left = mid + 1  
  18.        } else {  
  19.           right = mid - 1  
  20.        }  
  21.     }  
  22.   
  23.     return -1  
  24. }  
  25.   
  26. func main() {  
  27.     sortedArray := []int{1, 3, 5, 7, 9, 11, 13, 15, 17, 19}  
  28.   
  29.     testTargets := []int{7, 19, 20, 1, 0}  
  30.   
  31.     for _, target := range testTargets {  
  32.        index := binarySearch(sortedArray, target)  
  33.        if index != -1 {  
  34.           fmt.Printf("目标值 %d 在索引 %d 处找到\n", target, index)  
  35.        } else {  
  36.           fmt.Printf("目标值 %d 未找到\n", target)  
  37.        }  
  38.     }  
  39. }
复制代码
接下来，看下面的代码，由于在一些代码行上有汉字，所以阅读起来就很方便。
  1. package main
  3.   
  5. import "fmt"
  7.   
  9. // binarySearch 实现了在有序整数切片中使用二分查找算法查找目标值的函数
  11. // 参数 arr: 已排序的整数切片
  13. // 参数 target: 要查找的目标值
  15. // 返回值: 目标值的索引，如果未找到则返回 -1
  17. func binarySearch(arr []int, target int) int {
  19.     // 初始化左右边界
  21.     left, right := 0, len(arr)-1
  23.   
  25.     // 当左边界小于等于右边界时继续查找
  27.     for left <= right {
  29.         // 计算中间位置，使用 left + (right-left)/2 避免整数溢出
  31.         mid := left + (right-left)/2
  33.   
  35.         // 如果中间元素等于目标值，直接返回索引
  37.         if arr[mid] == target {
  39.             return mid
  41.         }
  44.         // 如果中间元素小于目标值，说明目标值在右半部分
  46.         if arr[mid] < target {
  48.             left = mid + 1
  50.         } else {
  52.             // 如果中间元素大于目标值，说明目标值在左半部分
  54.             right = mid - 1
  56.         }
  58.     }
  60.   
  62.     // 未找到目标值，返回 -1
  64.     return -1
  66. }
  68.   
  70. // main 函数演示二分查找的使用
  72. func main() {
  74.     // 创建一个有序的整数切片
  76.     sortedArray := []int{1, 3, 5, 7, 9, 11, 13, 15, 17, 19}
  78.   
  80.     // 定义要查找的测试目标值
  82.     testTargets := []int{7, 19, 20, 1, 0}
  84.   
  86.     // 遍历测试目标值，并使用二分查找进行查找
  88.     for _, target := range testTargets {
  90.         // 调用二分查找函数
  92.         index := binarySearch(sortedArray, target)
  94.         // 根据查找结果打印信息
  96.         if index != -1 {
  98.             fmt.Printf("目标值 %d 在索引 %d 处找到\n", target, index)
  100.         } else {
  102.             fmt.Printf("目标值 %d 未找到\n", target)
  104.         }
  106.     }
  108. }
复制代码
我们通过用自己熟悉的语言（比方，中文），在步伐中对某些代码进行标注说明，这就是注释的作用，可以大概大大增强步伐的可读性。
以后，如果是相助开辟，其他步伐员会常常阅读我们写的代码，固然，我们也会常常阅读别的步伐员写的代码，如果代码中加了注释，那么阅读起来就非常容易了。
2、 注释分类

Go 语言支持两种类型的注释：单行注释和多行注释。
1. 单行注释 (Single-line comments)

单行注释用于注释掉一行代码。它以 // 开头，后面的内容将被视为注释，直到该行结束。单行注释可以放在代码行的任何位置，且不会影响代码的执行。
示例：

  1. // 这是一个单行注释
  2. fmt.Println("Hello, World!") // 这是行尾注释
复制代码
在上面的示例中，// 后面的文本 这是一个单行注释 和 这是行尾注释 都是注释部分，不会被 Go 编译器执行。
2. 多行注释 (Multi-line comments)

多行注释用于注释掉多行代码。它以 /* 开始，以 */ 结束。多行注释可以跨越多行，用于注释大段代码或提供具体的说明。
示例：

  1. /*
  2. 这是一个多行注释的例子。
  3. 可以用于注释掉多行代码。
  4. 这不会影响程序的执行。
  5. */
  6. fmt.Println("Hello, World!")
复制代码
在上面的示例中，/* 和 */ 之间的文本会被视为注释，而且可以跨越多行。
小结


这两种注释方式都有助于步伐员在代码中添加说明或者临时注释掉部分代码，提升代码的可读性和可维护性。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。



欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/) Powered by Discuz! X3.4