The Go Programming Language

入门 #

格式化字符串：

%d        十进制整数
%x,%0,%b  十六进制，八进制，二进制整数
%b,%e      浮点数：3.14.1592 3.14159265389793 3.141593e+00
%t        布尔：true 或 false
%s        字符串
%q        带双引号的字符串 "abc" 或带单引号的字符 'c'
%v        变量的自然形式（natural format）
%T        变量的类型
%%        字面上的百分号标志（无操作数）

程序结构 #

指针 #

每次对一个变量取地址或者复制指针，都是为原变量创建了新的别名。于此可以不用名字而访问一个变量，但同时是一把双刃剑：要找到一个变量的所有的访问者变得困难。

new 函数 #

func newInt() *int {
  return new(int)
}

func newInt() *int {
  var dummy int
  return &dummy
}

每次调用 new 函数都是返回一个新的变量的地址，因此下面两个地址是不同的：

p := new(int)
q := new(int)
fmt.Println(q == p) // false

当然也可能有特殊情况：如果两个类型都是空的，即类型的大小是 0，例如 struct{} 和 [0]int，有可能有相同的地址（依赖具体的语言实现）。请谨慎使用大小为 0 的类型，因为如果类型的大小为 0 的话，可能导致 Go 语言的自动垃圾回收器有不同的行为，具体请查看 runtime.SetFinalizer 函数相关文档。

变量的生命周期 #

var global *int
func f(){
  var x int
  x = 1
  global = &x
}
 
func g(){
  y := new(int)
  *y = 1
}

包和文件 #

包的初始化 #

包的初始化首先是解决包级变量的依赖顺序，然后按照包级变量声明出现的顺序依次初始化：

var a = b + c // a 第三个初始化，为 3
var b = f() // b 第二个初始化，为 2，通过调用 f（依赖 c）
var c = 1   // c 第一个初始化，为 1

func f() int { return c + 1}

如果包中含有多个 .go 源文件，它们将按照发给编译器的顺序进行初始化，GO 语言的构建工具首先会将 .go 文件根据文件名排序，然后依次调用编译器编译。

作用域 #

作用域和生命周期并不是同一个概念，作用域是声明语句对应的源码文本范围；它是一个编译时的属性。变量的生命周期是只程序运行时变量存在的有效时间段，在此时间区间可被其他部分引用；是一个运行时的概念。

P78

基础数据类型 #

字符串 #

字符串的值是不可变的：一个字符串包含的字节序列永远不会被改变，当然也可以给一个字符串变量分配一个新的字符串值，但是并不会导致原始的字符串值被改变，变量会持有一个新的字符串值。

因为字符串是不可修改的，因此尝试修改字符串内部数据的操作也是被禁止的：

s[0] = 'L' // compile error: cannot assign to s[0]

不变性意味如果两个字符串共享相同的底层数据的也是安全的，这使得复制任何长度字符串的代价是低廉的。同样，一个字符串 S 和对应的子串切片 S[7:] 的操作也可以安全地共享相同的内存，因此字符串切片操作的代价也是低廉的。

字符串和 Byte 切片 #

一个字符串是包含的只读字节数组，一旦创建，是不可变的。相比之下，一个字节 slice 的元素则可以自由地修改。

s := "abc"
b := []byte(s)
s2 := string(b)

从概念上讲，一个 []byte(s) 转换是分配了一个新的字节数组用于保存字符串数据的拷贝，然后引用这个底层的字节数组。编译器的优化可以避免在一些场景下分配和复制字符串数据，但总的来说需要确保在变量 b 被修改的情况下，原始的 s 字符串也不会被改变。

为了避免转换中不必要的内存分配，bytes 包和 strings 包同时提供了许多实用函数：

func Contains(s, substr string) bool
func Count(s, sep string) bool
func Fields(s string) []string
func HasPrefix(s, prefix string) bool
func Index(s, sep string) int
func Join(a []string, sep string) string

常量 #

iota 常量生成器 #

复合数据类型 #

Slice #

Slice 不支持比较运算符，因为 slice 的元素是间接引用的，一个 slice 甚至可以包含自身。一个固定的 slice 值在不同时刻可能包含不同的元素，因为底层数组的元素可能会被修改。例如 slice 的扩容，会导致其本身的值/地址变化。

判断一个 slice 是否为空时，使用 len(s) == 0 来判断，而不应该用 s == nil 来判断。所有的 Go 语言函数应该已相同的方式对待 nil 值的 slice 和 0 长度的 slice。

append 函数 #

TODO 内置 append 内存扩展策略。

通常我们并不知道 append 调用是否导致了内存的重新分配，因此不能确认新的 slice 和原始 slice 是否引用相同的底层数组。也无法确认在原先的 slice 上操作是否会影响到新的 slice。因此通常是将 append 的返回的结果直接赋值给输入的 slice 变量。

更新 slice 变量不仅对调用 append 函数是必要的，对任何可能导致长度、容量或底层数组变化的操作都是必要。尽管 slice 间接访问底层的数组，但是 slice 对应结构体本身的指针、长度和容量部分都是直接访问的。更新这些信息需要显示赋值。从这个角度看，slice 并不是一个纯粹的引用类型。

slice 内存技巧 #

slice 可以用来模拟 stack

Map #

map 中的元素并不是一个变量，因此不能对 map 的元素进行取址操作：

_ = &ages["alomerry"] // compile error: cannot take address of map element

禁止对 map 元素取址的原因是 map 可能随着元素数量的增长而重新分配更大的内存空间，从而可能导致之前的地址无效。

map 的迭代顺序是随机的，这是故意的，每次都使用随机的遍历顺序可以强制要求程序不会依赖具体的哈希函数实现。

map 类型的零值是 nil，也就是没有引用任何哈希表。查找、删除、len 和 range 循环都可以安全的工作在 nil 值的 map 上。但是向一个 nil 值的 map 存入元素将导致 panic 异常。

通过 key 作为索引下表来访问 map 将产生一个 value。如果 key 不存在，那么将得到 value 对应类型的零值。

结构体 #

如果要在函数内部修改结构体成员的话，必须使用指针。因为在 Go 语言中，所有的函数参数都是值拷贝传入的，函数参数将不再是函数调用时的原始变量。

结构体嵌入和匿名成员 #

Go 语言有一个特性让我们只声明一个成员对应的数据类型而不指明成员的名字；这类成员就角匿名成员。匿名成员的数据类型必须是命名的类型或指向一个命名的类型的指针。下面的代码中，Circle 和 Wheel 各自都有一个匿名结构成员。

type Point struct {
X, Y int
}
type Circle struct {
Point
Radius int
}
type Wheel struct {
Circle
Spokes int
}

得意于匿名嵌入的特性，我们可以直接访问叶子属性而不需要给出完整的路径：

var w Wheel
w.X = 8 // equivalent to w.Circle.Point.X = 8
w.Y = 8 // equivalent to w.Circle.Point.Y = 8
w.Radius = 5 // equivalent to w.Circle.Radius = 5
w.Spokes = 5

JSON #

文本和 HTML 模板 #

TODO

函数 #

函数声明 #

在函数体中，函数的形参作为局部变量，被初始化为调用者提供的值。函数的形参和有名返回值作为函数最外层的局部变量，被存储在相同的语法块中。

实参通过值的方式传递，因此函数的形参是实参的拷贝。对形参进行修改不会影响实参。但是如果实参包含引用类型，如指针、slice、map、function、channel 等类型，实参可能会由于函数的间接引用被修改。

错误 #

错误处理策略 #

• 传播错误
• 重试
• 输出错误信息，结束程序
  • 需要注意的是，这种策略只应该在 main 中执行。对于库函数而言，应仅向上传播错误，除非该错误意味着程序内部包含不一致性，即遇到了 bug，才能在库函数中结束程序。
• 仅输出错误信息，保持程序运行
• 忽略错误

匿名函数 #

匿名函数可以访问完整的语法环境。

func squares() func () int {
var x int
return func () int {
x++
return x * x
}
}

func main(){
f := squares()
fmt.Println(f()) // "1"
fmt.Println(f()) // "4"
fmt.Println(f()) // "9"
fmt.Println(f()) // "16"
}

在 squares 中定义的匿名内部函数可以访问和更新 squares 中的局部变量，这意味着匿名函数和 squares 中存在变量引用。这就是函数值属于引用类型和函数值不可比较的原因。

该例子中，变量的生命周期不由它的作用域决定，squares 返回后，变量 x 仍然隐式的存在于 f 中。

警告：捕获迭代变量 #

var rmdirs []func ()
for _, d := range tempDirs() {
os.MkdirAll(dir, 0755)
rmdirs = append(rmdirs, func () {
os.RemoveAll(dir) // NOTE: incorrect!
})
}
// ...do some work ...
for _, rmdir := range rmdirs {
rmdir() // clean up
}

上面的程序是错误的，for 循环语句引入了新的语法块，循环变量 dir 在这个语法块中被声明。在该循环中生成的所有函数值都共享相同的循环变量。函数值中记录的是循环变量的内存地址，，而不是循环变量某一时刻的值。

这个问题不仅存在基于 range 的循环中，下面例子有同样的问题：

var rmdirs []func ()
dirs := tempDirs()
for i := 0; i < len(dirs); i++ {
os.MkdirAll(dirs[i], 0755)
rmdirs = append(rmdirs, func () {
os.RemoveAll(dirs[i]) // NOTE: incorrect!
})
}

Deferred 函数 #

当 defer 语句被执行时，跟在 defer 后面的函数会被延迟执行。直到包含 该 defer 语句的函数执行完毕时，defer 后面的函数才会被执行，不论包含 defer 语句的函数是通过 return 正常结束，还是由于 panic 导致的异常结束。一个函数中可以执行多条 defer 语句，它们的执行顺序与声明顺序相反。

defer 语句经常被用于处理成对的操作，如打开、关闭、连接、断开连接、加锁、释放锁。

调试复杂程序时，defer 机制也常被用于记录何时进入和退出函数。

func bigSlowOperation(){
defer trace("bigSlowOperation")() // don't forget the
extra parentheses
// ...lots of work...
time.Sleep(10 *  time.Second) // simulate slow
operation by sleeping
}
func trace(msg string) func () {
start := time.Now()
log.Printf("enter %s", msg)
return func () {
log.Printf("exit %s (%s)", msg, time.Since(start))
}
}

上例中 bigSlowOperation 函数直接调用 trace 记录函数的被调情况。bigSlowOperation 被调时 trace 会返回一个函数值，该函数会在 bigSlowOperation 退出时被调用。

defer 语句中函数会在 return 语句更新返回值变量后再执行，又因为在函数中定义匿名函数可以访问该函数包括返回值变量在内的所有变量，所以对匿名函数采用 defer 机制，可以使其观察函数的返回值，甚至修改函数返回给调用者的返回值。

func double(x int) int {
return x + x
}
func triple(x int) (result int) {
defer func () { result += x }()
return double(x)
}
fmt.Println(triple(4)) // "12"

Panic 异常 #

在 Go 的 panic 机制中，延迟函数的调用在释放堆栈信息之前。

Recover 捕获异常 #

不加区分的恢复所有的 panic 异常是不可取的。因为在 panic 之后，无法保证包级别变量的状态仍然和我们预期一致。比如对数据结构的一次重要更新没有被完整完成、文件或者网络连接没有被关闭、获得的锁没有被释放。

不应该试图去恢复其他包引起的 panic，公有 API 应该将函数的运行失败作为 error 返回，而不是 panic。同样的，你也不应该恢复一个由他人开发的函数引起的 panic，比如说调用者传入的回调函数，因为无法确保这样是安全的。

但有时很难完全遵循规范，例如 net/http 包中提供了一个 web 服务器，将收到的请求分发给用户提供的处理函数。不能因为某个处理函数引发的 panic 异常而 kill 整个进程；web 服务器遇到处理函数导致的 panic 时会调用 recover，输出堆栈信息，继续运行。这种做法在实践中很便捷，但是也会引起资源泄露，或是因为 recover 操作导致其他问题。

基于以上原因，安全的做法是有选择性的 recover，只恢复应该被恢复的 panic 异常，此外这些异常所占的比例应该尽可能的低。为了标识某个 panic 是否应该被恢复，我们可以将 panic value 设置成特殊类型。在 recover 时对 panic value 进行检查，如果发现是特殊类型，就将 panic 作为 error 处理，如果不是则按照正常的 panic 进行处理。

// soleTitle returns the text of the first non-empty title element
// in doc, and an error if there was not exactly one.
func soleTitle(doc *html.Node) (title string, err error) {
type bailout struct{}
defer func () {
switch p := recover(); p {
case nil: // no panic
case bailout{}: // "expected" panic
err = fmt.Errorf("multiple title elements")
default:
panic(p) // unexpected panic; carry on panicking
}
}()
// Bail out of recursion if we find more than one nonempty title.
forEachNode(doc, func (n *html.Node) {
if n.Type == html.ElementNode && n.Data == "title" && n.FirstChild != nil {
if title != "" {
panic(bailout{}) // multiple titleelements
}
title = n.FirstChild.Data
}
}, nil)
if title == "" {
return "", fmt.Errorf("no title element")
}
return title, nil
}

方法 #

基于指针的接收器 #

如果命名类型T(译注：用type xxx定义的类型)的所有方法都是用T类型自己来做接收器(是 *T )

，那么拷贝这种类型的实例就是安全的；调用他的任何一个方法也就会产生一个拷贝。比如time.Duration的这个类型，在调用其方法时就会被全部拷贝一份，包括在作数传入函数的时候。但是如果一个方法使用指针作为接收器，你需要避免对其进行拷贝为这样可能会破坏掉该类型内部的不变性。比如你对bytes.Buffer对象进行了拷贝，那么会引起原始对象和拷贝对象只是别名而已，但实际上其指向的对象是一致的。紧接着对后的变量进行修改可能会有让你意外的结果。译注：

作者这里说的比较绕，其实有两点：1. 不管你的method的receiver是指针类型还是非指针类型，都是可以通过指针/非指针进行调用的，编译器会帮你做类型转换。2.

在声明一个method的receiver该是指针还是非指针类型时，你需要考虑两方面的内一方面是这个对象本身是不是特别大，如果声明为非指针变量时，调用会产生一次贝；第二方面是如果你用指针类型作为receiver，那么你一定要注意，这种指针类型的始终是一块内存地址，就算你对其进行了拷贝。熟悉C或者C艹的人这里应该很快白。

Nil 也是合法的接收器类型 #

对Get的最后一次调用中，nil接收器的行为即是一个空map的行为。我们可以等价地将这个操 作写成Value(nil).Get("item")，但是如果你直接写nil.Get("item")的话是无法通过编译的，因为 nil的字面量编译器无法判断其准备类型。所以相比之下，最后的那行m.Add的调用就会产生一 个panic，因为他尝试更新一个空map。 gopl 基于指针对象的方法 215 由于url.Values是一个map类型，并且间接引用了其key/value对，因此url.Values.Add对这个 map里的元素做任何的更新、删除操作对调用方都是可见的。实际上，就像在普通函数中一 样，虽然可以通过引用来操作内部值，但在方法想要修改引用本身是不会影响原始值的，比 如把他置为nil，或者让这个引用指向了其它的对象，调用方都不会受影响。（译注：因为传 入的是存储了内存地址的变量，你改变这个变量是影响不了原始的变量的，想想C语言，是差 不多的）

接口 #

Go 语言中接口类型的独特之处在于它是满足隐式实现的，即没有必要对于给定的具体类型定义所有满足的接口类型。

Goroutines 和 Channels #

基于共享变量的并发 #

包和工具 #

测试 #

反射 #

底层编程 #

练习 #

1.3 测量潜在低效的版本和使用了 strings.Join 的版本的运行事件差异。 #

func main() {
  start := time.Now()

  array, result := []string{
    "a", "b", "c", "d", "e", "f", "g",
  }, ""

  for i := 0; i < 10000; i++ {
    for j := range array {
      result += array[j]
    }
  }
  sec := time.Since(start).Seconds()
  fmt.Println(sec)
}

0.376342

func main() {
  start := time.Now()

  array, result := []string{
    "a", "b", "c", "d", "e", "f", "g",
  }, ""

  for i := 0; i < 10000; i++ {
    result = strings.Join(array, "")
  }
  sec := time.Since(start).Seconds()
  fmt.Println(sec)
}

0.0480443

Reference #