37.笔记go语言——包

37.笔记go语言——包

包是函数和数据的集合。用package保留字定义一个包。文件名不需要与包名一致。包名的约定是使用小写字符。Go包可以由多个文件组成，但是使用相同的package <name>这一行。让我们在文件even.go中定义一个叫做even的包。

名称以大写字母起始的是可导出的，可以在包的外部调用.

在Go中，当函数的首字母大写的时候，函数会被从包中导出（在包外部可见，或者说公有的）

概括来说：

•公有函数的名字以大写字母开头；

•私有函数的名字以小写字母开头。

这个规则同样适用于定义在包中的其他名字（新类型、全局变量）。注意，“大写”的含义并不仅限于US ASCII，它被扩展到了整个Unicode范围。所以大写的希腊语、古埃及语都是可以的。

标识符

像在其他语言中一样，Go的命名是很重要的。在某些情况下，它们甚至有语义上的作用：例如，在包外是否可见决定于首字母是不是大写。因此有必要花点时间讨论一下Go程序的命名规则。

包名

当包导入（通过import）时，包名成为了内容的入口。在import "bytes"之后，导入包的可以调用函数bytes.Buffer。任何使用这个包的人，可以使用同样的名字访问到它的内容，因此这样的包名是好的：短的、简洁的、好记的。

根据规则，包名是小写的一个单词；不应当有下划线或混合大小写。由于每个人都可能需要录入这个名字，所以尽可能的简短。不要提前考虑冲突。包名是导入的默认名称。

在Go中使用混合大小写MixedCaps或者mixedCaps，而不是下划线区分含有多个单词的名字。

包的文档

每个包都应该有包注释，在package前的一个注释块。对于多文件包，包注释只需要出现在一个文件前，任意一个文件都可以。包注释应当对包进行介绍，并提供相关于包的整体信息。这会出现在go doc生成的关于包的页面上，并且相关的细节会一并显示。

每个定义（并且导出）的函数应当有一小段文字描述该函数的行为。

测试包

在Go中为包编写单元测试应当是一种习惯。编写测试需要包含testing包和程序go test。两者都有良好的文档。

在编写包的时候应当一边写代码，一边写（一些）文档和测试函数。这可以让你的程序更好，并且它展示了你的努力。

常用的包

标准的Go代码库中包含了大量的包，并且在安装Go的时候多数会伴随一起安装。浏览$GOROOT/src/pkg目录并且查看那些包会非常有启发。

fmt

包fmt实现了格式化的I/O函数，这与C的printf和scanf类似。格式化短语派生于C。一些短语（%-序列）这样使用：

%v

默认格式的值。当打印结构时，加号（%+v）会增加字段名；

%#v

Go样式的值表达；

%T

带有类型的Go样式的值表达；

io

这个包提供了原始的I/O操作界面。它主要的任务是对os包这样的原始的I/O进行封装，增加一些其他相关，使其具有抽象功能用在公共的接口上。

bufio

这个包实现了缓冲的I/O。它封装于io.Reader和io.Writer对象，创建了另一个对象（Reader和Writer）在提供缓冲的同时实现了一些文本I/O的功能。

sort

sort包提供了对数组和用户定义集合的原始的排序功能。

strconv

strconv包提供了将字符串转换成基本数据类型，或者从基本数据类型转换为字符串的功能。

os

os包提供了与平台无关的操作系统功能接口。其设计是Unix形式的。

sync

sync包提供了基本的同步原语，例如互斥锁。

flag

flag包实现了命令行解析。

encoding/json

encoding/json包实现了编码与解码RFC 4627 [5]定义的JSON对象。

text/template

数据驱动的模板，用于生成文本输出，例如HTML。

将模板关联到某个数据结构上进行解析。模板内容指向数据结构的元素（通常结构的字段或者map的键）控制解析并且决定某个值会被显示。模板扫描结构以便解析，而“游标” @决定了当前位置在结构中的值。

net/http

net/http实现了HTTP请求、响应和URL的解析，并且提供了可扩展的HTTP服务和基本的HTTP客户端。

unsafe

unsafe包包含了Go程序中数据类型上所有不安全的操作。通常无须使用这个。

reflect

reflect包实现了运行时反射，允许程序通过抽象类型操作对象。通常用于处理静态类型interface{}的值，并且通过Typeof解析出其动态类型信息，通常会返回一个有接口类型Type的对象。

os/exec

os/exec包执行外部命令。