golang基础教程（二）、开发规范及API

golang基础教程

在go语言中代码的规范很重要，符号的位置，无用的包等官方都有严格的要求（其实goland在编写代码时就会提醒的！！）

一、注释

用于注解说明解释程序的文字就是注释，注释提高了代码的阅读性；
注释是一个程序员必须要具有的良好编程习惯。将自己的思想通过注释先整理出来，再用代码去
体现。

1、行注释

基本语法

// 注释内容

举例：

package main

import "fmt"

func main() {
	//这是一段注释
	//没有注释的程序，都是在耍流氓
	fmt.Println("注释虽好，单页不要太多！！")
}

块注释(多行注释)

基本语法:

/*
注释内容
*/

举例:

package main
/*
import "fmt"

func main() {
	//这是一段注释
	//没有注释的程序，都是在耍流氓
	fmt.Println("注释虽好，单页不要太多！！")
}
*/

二、规范的代码风格

1、正确的注释和注释风格、正确的缩进和空白

这些可以使用gofmt 指令来完成（每次写完代码还得敲命令，挺麻烦）

可以使用golang得快捷键完成 ctrl+alt+l
注意这个快捷键会和系统得锁屏或intel显卡驱动冲突，可以禁用调系统得快捷键
2、Go 语言的代码风格.
错误示例

package main

import "fmt"

func main() 
{
	//这是一段注释
	//没有注释的程序，都是在耍流氓
	fmt.Println("注释虽好，单页不要太多！！")
}

注意大括号不能换行

可以看到goland已经报错了
3、一行最长不超过 80 个字符，超过的请使用换行展示，尽量保持格式优雅

三、Golang 标准库 API 文档

Golang 中文网 在线标准库文档： https://studygolang.com/pkgdoc
离线版的 Golang_Manual_By_AstaXie_20120522.chm，需要得可以留下邮箱