Golang语言开发注意事项

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　作者：尹正杰

版权声明：原创作品，谢绝转载！否则将追究法律责任。

目录

• 一.Go语法注意事项
• 二.Go语法注释
• 三.代码风格
• 四.应用编程接口API
• 五.Go注释与godoc详解

一.Go语法注意事项

- Golang源代码文件以".go"为扩展名;

- Golang程序的执行入口是"main()"函数;

- Golang严格区分字母大小写;

- 方法由一条条语句构成，每个语句后不需要分号(Go语言会在每行后自动加分号)，这也体现出Golang的简洁性。

- Go编辑器是一行行进行编译的，因此我们一行就写一条语句，不要把多个语句写在同一行，否则报错;

- 定义变量或者import的包如何没有使用到，代码不能编译通过。

- 大括号都是成对出现的，缺一不可。

二.Go语法注释

注释的作用:
	用于注解说明程序的文字就是注释，注释提高了代码的阅读性，注释是一个程序必须要具有的良好编程习惯。
	注释可以将自己的思想通过注释先成立出现，再用代码去实现。
		
Golang中注释类型:
	Go语言支持C语言风格的块注释，也支持c++风格的行注释。
		行注释:
			使用"//"，对应VSCode快捷键: "ctrl + /"。
		块注释:
			也称为多行注释，使用"/**/"，对应VSCode快捷键: "shift + alt + a"。

温馨提示:
	1.块注释中不可以嵌套块注释。
	2.相比于块注释，行注释更通用，块注释主要用于针对包的详细说明或者屏蔽大块的代码。

三.代码风格

- 注意缩进;

- 成对编程，如使用"",'',{},()等;

- 运算符两边加空白;

- 代码注释(官方Go语言源码大量使用"行注释");

- 一行代码最长不超过80个字符，超过请使用换行展示，尽量保持格式优雅;

温馨提示:
	可以使用"gofmt -w xxx.go"

四.应用编程接口API

应用程序接口（Application Programming Interface，简称"API"）:
	是一些预先定义的函数，或指软件系统不同组成部分衔接的约定。
	目的是提供应用程序与开发人员基于某软件或硬件得以访问一部分代码的能力，而又无需访问源码，或理解内部工作机制的细节。
	
Go语言提供了大量标准库，因此google公司也为这些标准库提供了相应的API文档，用于高速开发者如何使用这些标准库，以及标准库包含的方法。

官方网址:(需"FQ")
	https://golang.org
	
Golang中文网在线标准库文档:
	https://studygolang.com/pkgdoc

五.Go注释与godoc详解

推荐阅读:
    https://www.cnblogs.com/yinzhengjie/p/18241346