Go 语言编译器的 "//go:" 详解

前言

C 语言的 #include

一上来不太好说明白 Go 语言里 //go: 是什么，咱们先来看下很是简单，也是几乎每一个写代码的人都知道的东西：C 语言的 #include。
我猜，大部分人第一行代码都是 #include 吧。完整的就是#include <stdio.h>。意思很简单，引入一个 stdio.h。谁引入？答案是编译器。那么，# 字符的做用就是给 编译器 一个 指示，让编译器知道接下来要作什么。

编译指示

在计算机编程中，编译指示(pragma)是一种语言结构，它指示编译器应该如何处理其输入。指示不是编程语言语法的一部分，因编译器而异。

这里 Wiki 详细介绍了它，值得你看一下。

Go 语言的编译指示

官方文档 https://golang.org/cmd/compil...

形如 //go: 就是 Go 语言编译指示的实现方式。相信看过 Go SDK 的同窗对此并不陌生，常常能在代码函数声明的上一行看到这样的写法。
有同窗会问了，// 这不是注释吗？确实，它是以注释的形式存在的。

编译器源码 这里能够看到所有的指示，可是要注意， //go: 是连续的， // 和 go 之间并无空格。

经常使用指示详解

//go:noinline

noinline 顾名思义，不要内联。

Inline 内联

Inline，是在编译期间发生的，将函数调用调用处替换为被调用函数主体的一种编译器优化手段。Wiki： Inline 定义

使用 Inline 有一些优点，一样也有一些问题。

优点：

• 减小函数调用的开销，提升执行速度。
• 复制后的更大函数体为其余编译优化带来可能性，如 过程间优化
• 消除分支，并改善空间局部性和指令顺序性，一样能够提升性能。

问题：

• 代码复制带来的空间增加。
• 若是有大量重复代码，反而会下降缓存命中率，尤为对 CPU 缓存是致命的。

因此，在实际使用中，对因而否使用内联，要谨慎考虑，并作好平衡，以使它发挥最大的做用。
简单来讲，对于短小并且工做较少的函数，使用内联是有效益的。

内联的例子

func appendStr(word string) string {
    return "new " + word
}

执行 GOOS=linux GOARCH=386 go tool compile -S main.go > main.S
我截取有区别的部分展出它编译后的样子：

0x0015 00021 (main.go:4)    LEAL    ""..autotmp_3+28(SP), AX
    0x0019 00025 (main.go:4)    PCDATA    $2, $0
    0x0019 00025 (main.go:4)    MOVL    AX, (SP)
    0x001c 00028 (main.go:4)    PCDATA    $2, $1
    0x001c 00028 (main.go:4)    LEAL    go.string."new "(SB), AX
    0x0022 00034 (main.go:4)    PCDATA    $2, $0
    0x0022 00034 (main.go:4)    MOVL    AX, 4(SP)
    0x0026 00038 (main.go:4)    MOVL    $4, 8(SP)
    0x002e 00046 (main.go:4)    PCDATA    $2, $1
    0x002e 00046 (main.go:4)    LEAL    go.string."hello"(SB), AX
    0x0034 00052 (main.go:4)    PCDATA    $2, $0
    0x0034 00052 (main.go:4)    MOVL    AX, 12(SP)
    0x0038 00056 (main.go:4)    MOVL    $5, 16(SP)
    0x0040 00064 (main.go:4)    CALL    runtime.concatstring2(SB)

能够看到，它并无调用 appendStr 函数，而是直接把这个函数体的功能内联了。

那么话说回来，若是你不想被内联，怎么办呢？此时就该使用 go//:noinline 了，像下面这样写：

//go:noinline
func appendStr(word string) string {
    return "new " + word
}

编译后是：

0x0015 00021 (main.go:4)    LEAL    go.string."hello"(SB), AX
    0x001b 00027 (main.go:4)    PCDATA    $2, $0
    0x001b 00027 (main.go:4)    MOVL    AX, (SP)
    0x001e 00030 (main.go:4)    MOVL    $5, 4(SP)
    0x0026 00038 (main.go:4)    CALL    "".appendStr(SB)

此时编译器就不会作内联，而是直接调用 appendStr 函数。

//go:nosplit

nosplit 的做用是：跳过栈溢出检测。

栈溢出是什么？

正是由于一个 Goroutine 的起始栈大小是有限制的，且比较小的，才能够作到支持并发不少 Goroutine，并高效调度。
stack.go 源码中能够看到，_StackMin 是 2048 字节，也就是 2k，它不是一成不变的，当不够用时，它会动态地增加。
那么，必然有一个检测的机制，来保证能够及时地知道栈不够用了，而后再去增加。
回到话题，nosplit 就是将这个跳过这个机制。

优劣

显然地，不执行栈溢出检查，能够提升性能，但同时也有可能发生 stack overflow 而致使编译失败。

//go:noescape

noescape 的做用是：禁止逃逸，并且它必须指示一个只有声明没有主体的函数。

逃逸是什么？

Go 相比 C、C++ 是内存更为安全的语言，主要一个点就体如今它能够自动地将超出自身生命周期的变量，从函数栈转移到堆中，逃逸就是指这种行为。

请参考我以前的文章， 逃逸分析。

优劣

最显而易见的好处是，GC 压力变小了。
由于它已经告诉编译器，下面的函数不管如何都不会逃逸，那么当函数返回时，其中的资源也会一并都被销毁。
不过，这么作表明会绕过编译器的逃逸检查，一旦进入运行时，就有可能致使严重的错误及后果。

//go:norace

norace 的做用是：跳过竞态检测
咱们知道，在多线程程序中，不免会出现数据竞争，正常状况下，当编译器检测到有数据竞争，就会给出提示。如：

var sum int

func main() {
    go add()
    go add()
}

func add() {
    sum++
}

执行 go run -race main.go 利用 -race 来使编译器报告数据竞争问题。你会看到：

==================
WARNING: DATA RACE
Read at 0x00000112f470 by goroutine 6:
  main.add()
      /Users/sxs/Documents/go/src/test/main.go:15 +0x3a

Previous write at 0x00000112f470 by goroutine 5:
  main.add()
      /Users/sxs/Documents/go/src/test/main.go:15 +0x56

Goroutine 6 (running) created at:
  main.main()
      /Users/sxs/Documents/go/src/test/main.go:11 +0x5a

Goroutine 5 (finished) created at:
  main.main()
      /Users/sxs/Documents/go/src/test/main.go:10 +0x42
==================
Found 1 data race(s)

说明两个 goroutine 执行的 add() 在竞争。

优劣

使用 norace 除了减小编译时间，我想不到有其余的优势了。但缺点却很明显，那就是数据竞争会致使程序的不肯定性。

总结

我认为绝大多数状况下，无需在编程时使用 //go: Go 语言的编译器指示，除非你确认你的程序的性能瓶颈在编译器上，不然你都应该先去关心其余更可能出现瓶颈的事情。

参考

• https://dave.cheney.net/2018/...