diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..270cca8
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+*.* linguist-language=Go
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/Bug_report.md b/.github/ISSUE_TEMPLATE/Bug_report.md
new file mode 100644
index 0000000..93490d1
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/Bug_report.md
@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: 书籍勘误
+---
+
+## 实际描述
+
+- 原文页码:
+- 原文段落:
+
+```
+复制原文段落
+```
+
+## 预期描述
+
+```
+修改后的段落
+```
+
+## 附图
+
+必要时,请附上相关页面的照片或者截图
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/Question.md b/.github/ISSUE_TEMPLATE/Question.md
new file mode 100644
index 0000000..0f68bd5
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/Question.md
@@ -0,0 +1,9 @@
+---
+name: Question
+about: 提交问题
+
+---
+
+## 问题描述
+
+请在此描述你的问题,提问前请参考[提问的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md)
\ No newline at end of file
diff --git a/.github/workflows/website.yml b/.github/workflows/website.yml
new file mode 100644
index 0000000..ff972c2
--- /dev/null
+++ b/.github/workflows/website.yml
@@ -0,0 +1,41 @@
+name: Website
+on:
+ push:
+ branches: [ main ]
+jobs:
+
+ build:
+ name: Website
+ runs-on: ubuntu-latest
+ steps:
+
+ - name: Set up Go 1.16
+ uses: actions/setup-go@v1
+ with:
+ go-version: 1.16
+ id: go
+
+ - name: Setup Hugo
+ uses: peaceiris/actions-hugo@v2
+ with:
+ hugo-version: '0.80.0'
+ extended: true
+
+ - name: Check out code into the Go module directory
+ uses: actions/checkout@v1
+
+ - name: Build Website
+ env:
+ USER: ${{ secrets.SERVER_USER }}
+ TARGET: ${{ secrets.SERVER_PATH }}
+ KEY: ${{ secrets.SERVER_KEY }}
+ DOMAIN: ${{ secrets.SERVER_DOMAIN }}
+ run: |
+ make
+ mkdir ~/.ssh
+ echo "$KEY" | tr -d '\r' > ~/.ssh/id_ed25519
+ chmod 400 ~/.ssh/id_ed25519
+ eval "$(ssh-agent -s)"
+ ssh-add ~/.ssh/id_ed25519
+ ssh-keyscan -H $DOMAIN >> ~/.ssh/known_hosts
+ scp -r public/* $USER@$DOMAIN:$TARGET
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index de80d4c..e73fc3c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,3 +6,9 @@ log/
*.idea
*.DS_Store
+
+
+# Hugo website
+resources
+public
+data
diff --git a/GC/GC.md b/GC/GC.md
deleted file mode 100644
index 7571315..0000000
--- a/GC/GC.md
+++ /dev/null
@@ -1,1510 +0,0 @@
-> 当文中提及目前、目前版本等字眼时均指 Go 1.14,此外,文中所有 go 命令版本均为 Go 1.14。
-
-# GC 的认识
-
-## 1. 什么是 GC,有什么作用?
-
-`GC`,全称 `Garbage Collection`,即垃圾回收,是一种自动内存管理的机制。
-
-当程序向操作系统申请的内存不再需要时,垃圾回收主动将其回收并供其他代码进行内存申请时候复用,或者将其归还给操作系统,这种针对内存级别资源的自动回收过程,即为垃圾回收。而负责垃圾回收的程序组件,即为垃圾回收器。
-
-垃圾回收其实一个完美的 “Simplicity is Complicated” 的例子。一方面,程序员受益于 GC,无需操心、也不再需要对内存进行手动的申请和释放操作,GC 在程序运行时自动释放残留的内存。另一方面,GC 对程序员几乎不可见,仅在程序需要进行特殊优化时,通过提供可调控的 API,对 GC 的运行时机、运行开销进行把控的时候才得以现身。
-
-通常,垃圾回收器的执行过程被划分为两个半独立的组件:
-
-- 赋值器(Mutator):这一名称本质上是在指代用户态的代码。因为对垃圾回收器而言,用户态的代码仅仅只是在修改对象之间的引用关系,也就是在对象图(对象之间引用关系的一个有向图)上进行操作。
-- 回收器(Collector):负责执行垃圾回收的代码。
-
-## 2. 根对象到底是什么?
-
-根对象在垃圾回收的术语中又叫做根集合,它是垃圾回收器在标记过程时最先检查的对象,包括:
-
-1. 全局变量:程序在编译期就能确定的那些存在于程序整个生命周期的变量。
-2. 执行栈:每个 goroutine 都包含自己的执行栈,这些执行栈上包含栈上的变量及指向分配的堆内存区块的指针。
-3. 寄存器:寄存器的值可能表示一个指针,参与计算的这些指针可能指向某些赋值器分配的堆内存区块。
-
-## 3. 常见的 GC 实现方式有哪些?Go 语言的 GC 使用的是什么?
-
-所有的 GC 算法其存在形式可以归结为追踪(Tracing)和引用计数(Reference Counting)这两种形式的混合运用。
-
-- 追踪式 GC
-
- 从根对象出发,根据对象之间的引用信息,一步步推进直到扫描完毕整个堆并确定需要保留的对象,从而回收所有可回收的对象。Go、 Java、V8 对 JavaScript 的实现等均为追踪式 GC。
-- 引用计数式 GC
-
- 每个对象自身包含一个被引用的计数器,当计数器归零时自动得到回收。因为此方法缺陷较多,在追求高性能时通常不被应用。Python、Objective-C 等均为引用计数式 GC。
-
-目前比较常见的 GC 实现方式包括:
-
-- 追踪式,分为多种不同类型,例如:
- - 标记清扫:从根对象出发,将确定存活的对象进行标记,并清扫可以回收的对象。
- - 标记整理:为了解决内存碎片问题而提出,在标记过程中,将对象尽可能整理到一块连续的内存上。
- - 增量式:将标记与清扫的过程分批执行,每次执行很小的部分,从而增量的推进垃圾回收,达到近似实时、几乎无停顿的目的。
- - 增量整理:在增量式的基础上,增加对对象的整理过程。
- - 分代式:将对象根据存活时间的长短进行分类,存活时间小于某个值的为年轻代,存活时间大于某个值的为老年代,永远不会参与回收的对象为永久代。并根据分代假设(如果一个对象存活时间不长则倾向于被回收,如果一个对象已经存活很长时间则倾向于存活更长时间)对对象进行回收。
-- 引用计数:根据对象自身的引用计数来回收,当引用计数归零时立即回收。
-
-关于各类方法的详细介绍及其实现不在本文中详细讨论。对于 Go 而言,Go 的 GC 目前使用的是无分代(对象没有代际之分)、不整理(回收过程中不对对象进行移动与整理)、并发(与用户代码并发执行)的三色标记清扫算法。原因[1]在于:
-
-1. 对象整理的优势是解决内存碎片问题以及“允许”使用顺序内存分配器。但 Go 运行时的分配算法基于 tcmalloc,基本上没有碎片问题。 并且顺序内存分配器在多线程的场景下并不适用。Go 使用的是基于 tcmalloc 的现代内存分配算法,对对象进行整理不会带来实质性的性能提升。
-2. 分代 GC 依赖分代假设,即 GC 将主要的回收目标放在新创建的对象上(存活时间短,更倾向于被回收),而非频繁检查所有对象。但 Go 的编译器会通过**逃逸分析**将大部分新生对象存储在栈上(栈直接被回收),只有那些需要长期存在的对象才会被分配到需要进行垃圾回收的堆中。也就是说,分代 GC 回收的那些存活时间短的对象在 Go 中是直接被分配到栈上,当 goroutine 死亡后栈也会被直接回收,不需要 GC 的参与,进而分代假设并没有带来直接优势。并且 Go 的垃圾回收器与用户代码并发执行,使得 STW 的时间与对象的代际、对象的 size 没有关系。Go 团队更关注于如何更好地让 GC 与用户代码并发执行(使用适当的 CPU 来执行垃圾回收),而非减少停顿时间这一单一目标上。
-
-## 4. 三色标记法是什么?
-
-理解**三色标记法**的关键是理解对象的**三色抽象**以及**波面(wavefront)推进**这两个概念。三色抽象只是一种描述追踪式回收器的方法,在实践中并没有实际含义,它的重要作用在于从逻辑上严密推导标记清理这种垃圾回收方法的正确性。也就是说,当我们谈及三色标记法时,通常指标记清扫的垃圾回收。
-
-从垃圾回收器的视角来看,三色抽象规定了三种不同类型的对象,并用不同的颜色相称:
-
-- 白色对象(可能死亡):未被回收器访问到的对象。在回收开始阶段,所有对象均为白色,当回收结束后,白色对象均不可达。
-- 灰色对象(波面):已被回收器访问到的对象,但回收器需要对其中的一个或多个指针进行扫描,因为他们可能还指向白色对象。
-- 黑色对象(确定存活):已被回收器访问到的对象,其中所有字段都已被扫描,黑色对象中任何一个指针都不可能直接指向白色对象。
-
-这样三种不变性所定义的回收过程其实是一个**波面**不断前进的过程,这个波面同时也是黑色对象和白色对象的边界,灰色对象就是这个波面。
-
-当垃圾回收开始时,只有白色对象。随着标记过程开始进行时,灰色对象开始出现(着色),这时候波面便开始扩大。当一个对象的所有子节点均完成扫描时,会被着色为黑色。当整个堆遍历完成时,只剩下黑色和白色对象,这时的黑色对象为可达对象,即存活;而白色对象为不可达对象,即死亡。这个过程可以视为以灰色对象为波面,将黑色对象和白色对象分离,使波面不断向前推进,直到所有可达的灰色对象都变为黑色对象为止的过程。如下图所示:
-
-
-
-图中展示了根对象、可达对象、不可达对象,黑、灰、白对象以及波面之间的关系。
-
-## 5. STW 是什么意思?
-
-`STW` 可以是 `Stop the World` 的缩写,也可以是 `Start the World` 的缩写。通常意义上指指代从 `Stop the World` 这一动作发生时到 `Start the World` 这一动作发生时这一段时间间隔,即万物静止。STW 在垃圾回收过程中为了保证实现的正确性、防止无止境的内存增长等问题而不可避免的需要停止赋值器进一步操作对象图的一段过程。
-
-在这个过程中整个用户代码被停止或者放缓执行, `STW` 越长,对用户代码造成的影响(例如延迟)就越大,早期 Go 对垃圾回收器的实现中 `STW` 长达几百毫秒,对时间敏感的实时通信等应用程序会造成巨大的影响。我们来看一个例子:
-
-```go
-package main
-
-import (
- "runtime"
- "time"
-)
-
-func main() {
- go func() {
- for {
- }
- }()
-
- time.Sleep(time.Millisecond)
- runtime.GC()
- println("OK")
-}
-```
-
-上面的这个程序在 Go 1.14 以前永远都不会输出 `OK`,其罪魁祸首是进入 STW 这一操作的执行无限制的被延长。
-
-尽管 STW 如今已经优化到了半毫秒级别以下,但这个程序被卡死原因是由于需要进入 STW 导致的。原因在于,GC 在需要进入 STW 时,需要通知并让所有的用户态代码停止,但是 `for {}` 所在的 goroutine 永远都不会被中断,从而始终无法进入 STW 阶段。实际实践中也是如此,当程序的某个 goroutine 长时间得不到停止,强行拖慢进入 STW 的时机,这种情况下造成的影响(卡死)是非常可怕的。好在自 Go 1.14 之后,这类 goroutine 能够被异步地抢占,从而使得进入 STW 的时间不会超过抢占信号触发的周期,程序也不会因为仅仅等待一个 goroutine 的停止而停顿在进入 STW 之前的操作上。
-
-## 6. 如何观察 Go GC?
-
-我们以下面的程序为例,先使用四种不同的方式来介绍如何观察 GC,并在后面的问题中通过几个详细的例子再来讨论如何优化 GC。
-
-```go
-package main
-
-func allocate() {
- _ = make([]byte, 1<<20)
-}
-
-func main() {
- for n := 1; n < 100000; n++ {
- allocate()
- }
-}
-```
-
-### 方式1:`GODEBUG=gctrace=1`
-
-我们首先可以通过
-
-```
-$ go build -o main
-$ GODEBUG=gctrace=1 ./main
-
-gc 1 @0.000s 2%: 0.009+0.23+0.004 ms clock, 0.11+0.083/0.019/0.14+0.049 ms cpu, 4->6->2 MB, 5 MB goal, 12 P
-scvg: 8 KB released
-scvg: inuse: 3, idle: 60, sys: 63, released: 57, consumed: 6 (MB)
-gc 2 @0.001s 2%: 0.018+1.1+0.029 ms clock, 0.22+0.047/0.074/0.048+0.34 ms cpu, 4->7->3 MB, 5 MB goal, 12 P
-scvg: inuse: 3, idle: 60, sys: 63, released: 56, consumed: 7 (MB)
-gc 3 @0.003s 2%: 0.018+0.59+0.011 ms clock, 0.22+0.073/0.008/0.042+0.13 ms cpu, 5->6->1 MB, 6 MB goal, 12 P
-scvg: 8 KB released
-scvg: inuse: 2, idle: 61, sys: 63, released: 56, consumed: 7 (MB)
-gc 4 @0.003s 4%: 0.019+0.70+0.054 ms clock, 0.23+0.051/0.047/0.085+0.65 ms cpu, 4->6->2 MB, 5 MB goal, 12 P
-scvg: 8 KB released
-scvg: inuse: 3, idle: 60, sys: 63, released: 56, consumed: 7 (MB)
-scvg: 8 KB released
-scvg: inuse: 4, idle: 59, sys: 63, released: 56, consumed: 7 (MB)
-gc 5 @0.004s 12%: 0.021+0.26+0.49 ms clock, 0.26+0.046/0.037/0.11+5.8 ms cpu, 4->7->3 MB, 5 MB goal, 12 P
-scvg: inuse: 5, idle: 58, sys: 63, released: 56, consumed: 7 (MB)
-gc 6 @0.005s 12%: 0.020+0.17+0.004 ms clock, 0.25+0.080/0.070/0.053+0.051 ms cpu, 5->6->1 MB, 6 MB goal, 12 P
-scvg: 8 KB released
-scvg: inuse: 1, idle: 62, sys: 63, released: 56, consumed: 7 (MB)
-```
-
-在这个日志中可以观察到两类不同的信息:
-
-```
-gc 1 @0.000s 2%: 0.009+0.23+0.004 ms clock, 0.11+0.083/0.019/0.14+0.049 ms cpu, 4->6->2 MB, 5 MB goal, 12 P
-gc 2 @0.001s 2%: 0.018+1.1+0.029 ms clock, 0.22+0.047/0.074/0.048+0.34 ms cpu, 4->7->3 MB, 5 MB goal, 12 P
-...
-```
-
-以及:
-
-```
-scvg: 8 KB released
-scvg: inuse: 3, idle: 60, sys: 63, released: 57, consumed: 6 (MB)
-scvg: inuse: 3, idle: 60, sys: 63, released: 56, consumed: 7 (MB)
-...
-```
-
-对于用户代码向运行时申请内存产生的垃圾回收:
-
-```
-gc 2 @0.001s 2%: 0.018+1.1+0.029 ms clock, 0.22+0.047/0.074/0.048+0.34 ms cpu, 4->7->3 MB, 5 MB goal, 12 P
-```
-
-含义由下表所示:
-
-| 字段 | 含义 |
-| :---- | :--------------------------------------------- |
-| gc 2 | 第二个 GC 周期 |
-| 0.001 | 程序开始后的 0.001 秒 |
-| 2% | 该 GC 周期中 CPU 的使用率 |
-| 0.018 | 标记开始时, STW 所花费的时间(wall clock) |
-| 1.1 | 标记过程中,并发标记所花费的时间(wall clock) |
-| 0.029 | 标记终止时, STW 所花费的时间(wall clock) |
-| 0.22 | 标记开始时, STW 所花费的时间(cpu time) |
-| 0.047 | 标记过程中,标记辅助所花费的时间(cpu time) |
-| 0.074 | 标记过程中,并发标记所花费的时间(cpu time) |
-| 0.048 | 标记过程中,GC 空闲的时间(cpu time) |
-| 0.34 | 标记终止时, STW 所花费的时间(cpu time) |
-| 4 | 标记开始时,堆的大小的实际值 |
-| 7 | 标记结束时,堆的大小的实际值 |
-| 3 | 标记结束时,标记为存活的对象大小 |
-| 5 | 标记结束时,堆的大小的预测值 |
-| 12 | P 的数量 |
-
-> wall clock 是指开始执行到完成所经历的实际时间,包括其他程序和本程序所消耗的时间;
-> cpu time 是指特定程序使用 CPU 的时间;
-> 他们存在以下关系:
->
-> - wall clock < cpu time: 充分利用多核
-> - wall clock ≈ cpu time: 未并行执行
-> - wall clock > cpu time: 多核优势不明显
-
-对于运行时向操作系统申请内存产生的垃圾回收(向操作系统归还多余的内存):
-
-```
-scvg: 8 KB released
-scvg: inuse: 3, idle: 60, sys: 63, released: 57, consumed: 6 (MB)
-```
-
-含义由下表所示:
-
-| 字段 | 含义 |
-| :------------ | :----------------------------------------------------------- |
-| 8 KB released | 向操作系统归还了 8 KB 内存 |
-| 3 | 已经分配给用户代码、正在使用的总内存大小 (MB) |
-| 60 | 空闲以及等待归还给操作系统的总内存大小(MB) |
-| 63 | 通知操作系统中保留的内存大小(MB) |
-| 57 | 已经归还给操作系统的(或者说还未正式申请)的内存大小(MB) |
-| 6 | 已经从操作系统中申请的内存大小(MB) |
-
-### 方式2:`go tool trace`
-
-`go tool trace` 的主要功能是将统计而来的信息以一种可视化的方式展示给用户。要使用此工具,可以通过调用 trace API:
-
-```go
-package main
-
-func main() {
- f, _ := os.Create("trace.out")
- defer f.Close()
- trace.Start(f)
- defer trace.Stop()
- (...)
-}
-```
-
-并通过
-
-```
-$ go tool trace trace.out
-2019/12/30 15:50:33 Parsing trace...
-2019/12/30 15:50:38 Splitting trace...
-2019/12/30 15:50:45 Opening browser. Trace viewer is listening on http://127.0.0.1:51839
-```
-
-命令来启动可视化界面:
-
-
-
-选择第一个链接可以获得如下图示:
-
-
-
-右上角的问号可以打开帮助菜单,主要使用方式包括:
-
-- w/s 键可以用于放大或者缩小视图
-- a/d 键可以用于左右移动
-- 按住 Shift 可以选取多个事件
-
-### 方式3:`debug.ReadGCStats`
-
-此方式可以通过代码的方式来直接实现对感兴趣指标的监控,例如我们希望每隔一秒钟监控一次 GC 的状态:
-
-```go
-func printGCStats() {
- t := time.NewTicker(time.Second)
- s := debug.GCStats{}
- for {
- select {
- case <-t.C:
- debug.ReadGCStats(&s)
- fmt.Printf("gc %d last@%v, PauseTotal %v\n", s.NumGC, s.LastGC, s.PauseTotal)
- }
- }
-}
-func main() {
- go printGCStats()
- (...)
-}
-```
-
-我们能够看到如下输出:
-
-```go
-$ go run main.go
-
-gc 4954 last@2019-12-30 15:19:37.505575 +0100 CET, PauseTotal 29.901171ms
-gc 9195 last@2019-12-30 15:19:38.50565 +0100 CET, PauseTotal 77.579622ms
-gc 13502 last@2019-12-30 15:19:39.505714 +0100 CET, PauseTotal 128.022307ms
-gc 17555 last@2019-12-30 15:19:40.505579 +0100 CET, PauseTotal 182.816528ms
-gc 21838 last@2019-12-30 15:19:41.505595 +0100 CET, PauseTotal 246.618502ms
-```
-
-### 方式4:`runtime.ReadMemStats`
-
-除了使用 debug 包提供的方法外,还可以直接通过运行时的内存相关的 API 进行监控:
-
-```go
-func printMemStats() {
- t := time.NewTicker(time.Second)
- s := runtime.MemStats{}
-
- for {
- select {
- case <-t.C:
- runtime.ReadMemStats(&s)
- fmt.Printf("gc %d last@%v, next_heap_size@%vMB\n", s.NumGC, time.Unix(int64(time.Duration(s.LastGC).Seconds()), 0), s.NextGC/(1<<20))
- }
- }
-}
-func main() {
- go printMemStats()
- (...)
-}
-```
-
-```go
-$ go run main.go
-
-gc 4887 last@2019-12-30 15:44:56 +0100 CET, next_heap_size@4MB
-gc 10049 last@2019-12-30 15:44:57 +0100 CET, next_heap_size@4MB
-gc 15231 last@2019-12-30 15:44:58 +0100 CET, next_heap_size@4MB
-gc 20378 last@2019-12-30 15:44:59 +0100 CET, next_heap_size@6MB
-```
-
-当然,后两种方式能够监控的指标很多,读者可以自行查看 `debug.GCStats` [2] 和
-`runtime.MemStats` [3] 的字段,这里不再赘述。
-
-## 7. 有了 GC,为什么还会发生内存泄露?
-
-在一个具有 GC 的语言中,我们常说的内存泄漏,用严谨的话来说应该是:预期的能很快被释放的内存由于附着在了长期存活的内存上、或生命期意外地被延长,导致预计能够立即回收的内存而长时间得不到回收。
-
-在 Go 中,由于 goroutine 的存在,所谓的内存泄漏除了附着在长期对象上之外,还存在多种不同的形式。
-
-### 形式1:预期能被快速释放的内存因被根对象引用而没有得到迅速释放
-
-当有一个全局对象时,可能不经意间将某个变量附着在其上,且忽略的将其进行释放,则该内存永远不会得到释放。例如:
-
-```go
-var cache = map[interface{}]interface{}{}
-
-func keepalloc() {
- for i := 0; i < 10000; i++ {
- m := make([]byte, 1<<10)
- cache[i] = m
- }
-}
-```
-
-### 形式2:goroutine 泄漏
-
-Goroutine 作为一种逻辑上理解的轻量级线程,需要维护执行用户代码的上下文信息。在运行过程中也需要消耗一定的内存来保存这类信息,而这些内存在目前版本的 Go 中是不会被释放的。因此,如果一个程序持续不断地产生新的 goroutine、且不结束已经创建的 goroutine 并复用这部分内存,就会造成内存泄漏的现象,例如:
-
-```go
-func keepalloc2() {
- for i := 0; i < 100000; i++ {
- go func() {
- select {}
- }()
- }
-}
-```
-
-### 验证
-
-我们可以通过如下形式来调用上述两个函数:
-
-```go
-package main
-
-import (
- "os"
- "runtime/trace"
-)
-
-func main() {
- f, _ := os.Create("trace.out")
- defer f.Close()
- trace.Start(f)
- defer trace.Stop()
- keepalloc()
- keepalloc2()
-}
-```
-
-运行程序:
-
-```shell
-go run main.go
-```
-
-会看到程序中生成了 `trace.out` 文件,我们可以使用 `go tool trace trace.out` 命令得到下图:
-
-
-
-可以看到,途中的 Heap 在持续增长,没有内存被回收,产生了内存泄漏的现象。
-
-值得一提的是,这种形式的 goroutine 泄漏还可能由 channel 泄漏导致。而 channel 的泄漏本质上与 goroutine 泄漏存在直接联系。Channel 作为一种同步原语,会连接两个不同的 goroutine,如果一个 goroutine 尝试向一个没有接收方的无缓冲 channel 发送消息,则该 goroutine 会被永久的休眠,整个 goroutine 及其执行栈都得不到释放,例如:
-
-```go
-var ch = make(chan struct{})
-
-func keepalloc3() {
- for i := 0; i < 100000; i++ {
- // 没有接收方,goroutine 会一直阻塞
- go func() { ch <- struct{}{} }()
- }
-}
-```
-
-## 8. 并发标记清除法的难点是什么?
-
-在没有用户态代码并发修改`三色抽象`的情况下,回收可以正常结束。但是并发回收的根本问题在于,用户态代码在回收过程中会并发地更新对象图,从而造成赋值器和回收器可能对对象图的结构产生不同的认知。这时以一个固定的三色波面作为回收过程前进的边界则不再合理。
-
-我们不妨考虑赋值器写操作的例子:
-
-| 时序 | 回收器 | 赋值器 | 说明 |
-| ---- | -------------------- | ------------------ | ------------------------------------------------------------ |
-| 1 | shade(A, gray) | | 回收器:根对象的子节点着色为灰色对象 |
-| 2 | shade(C, black) | | 回收器:当所有子节点着色为灰色后,将节点着为黑色 |
-| 3 | | C.ref3 = C.ref2.ref1 | 赋值器:并发的修改了 C 的子节点 |
-| 4 | | A.ref1 = nil | 赋值器:并发的修改了 A 的子节点 |
-| 5 | shade(A.ref1, gray) | | 回收器:进一步灰色对象的子节点并着色为灰色对象,这时由于 `A.ref1` 为 `nil`,什么事情也没有发生 |
-| 6 | shade(A, black) | | 回收器:由于所有子节点均已标记,回收器也不会重新扫描已经被标记为黑色的对象,此时 A 被着色为黑色,`scan(A)` 什么也不会发生,进而 B 在此次回收过程中永远不会被标记为黑色,进而错误地被回收。 |
-
-- 初始状态:假设某个黑色对象 C 指向某个灰色对象 A ,而 A 指向白色对象 B;
-- `C.ref3 = C.ref2.ref1`:赋值器并发地将黑色对象 C 指向(ref3)了白色对象 B;
-- `A.ref1 = nil`:移除灰色对象 A 对白色对象 B 的引用(ref2);
-- 最终状态:在继续扫描的过程中,白色对象 B 永远不会被标记为黑色对象了(回收器不会重新扫描黑色对象),进而对象 B 被错误地回收。
-
-
-
-总而言之,并发标记清除中面临的一个根本问题就是如何保证标记与清除过程的正确性。
-
-## 9. 什么是写屏障、混合写屏障,如何实现?
-
-要讲清楚写屏障,就需要理解三色标记清除算法中的**强弱不变性**以及**赋值器的颜色**,理解他们需要一定的抽象思维。写屏障是一个在并发垃圾回收器中才会出现的概念,垃圾回收器的正确性体现在:**不应出现对象的丢失,也不应错误的回收还不需要回收的对象。**
-
-可以证明,当以下两个条件同时满足时会破坏垃圾回收器的正确性:
-
-- **条件 1**: 赋值器修改对象图,导致某一黑色对象引用白色对象;
-- **条件 2**: 从灰色对象出发,到达白色对象的、未经访问过的路径被赋值器破坏。
-
-只要能够避免其中任何一个条件,则不会出现对象丢失的情况,因为:
-
-- 如果条件 1 被避免,则所有白色对象均被灰色对象引用,没有白色对象会被遗漏;
-- 如果条件 2 被避免,即便白色对象的指针被写入到黑色对象中,但从灰色对象出发,总存在一条没有访问过的路径,从而找到到达白色对象的路径,白色对象最终不会被遗漏。
-
-我们不妨将三色不变性所定义的波面根据这两个条件进行削弱:
-
-- 当满足原有的三色不变性定义(或上面的两个条件都不满足时)的情况称为**强三色不变性(strong tricolor invariant)**
-- 当赋值器令黑色对象引用白色对象时(满足条件 1 时)的情况称为**弱三色不变性(weak tricolor invariant)**
-
-当赋值器进一步破坏灰色对象到达白色对象的路径时(进一步满足条件 2 时),即打破弱三色不变性,
-也就破坏了回收器的正确性;或者说,在破坏强弱三色不变性时必须引入额外的辅助操作。
-弱三色不变形的好处在于:**只要存在未访问的能够到达白色对象的路径,就可以将黑色对象指向白色对象。**
-
-如果我们考虑并发的用户态代码,回收器不允许同时停止所有赋值器,就是涉及了存在的多个不同状态的赋值器。为了对概念加以明确,还需要换一个角度,把回收器视为对象,把赋值器视为影响回收器这一对象的实际行为(即影响 GC 周期的长短),从而引入赋值器的颜色:
-
-- 黑色赋值器:已经由回收器扫描过,不会再次对其进行扫描。
-- 灰色赋值器:尚未被回收器扫描过,或尽管已经扫描过但仍需要重新扫描。
-
-赋值器的颜色对回收周期的结束产生影响:
-
-- 如果某种并发回收器允许灰色赋值器的存在,则必须在回收结束之前重新扫描对象图。
-- 如果重新扫描过程中发现了新的灰色或白色对象,回收器还需要对新发现的对象进行追踪,但是在新追踪的过程中,赋值器仍然可能在其根中插入新的非黑色的引用,如此往复,直到重新扫描过程中没有发现新的白色或灰色对象。
-
-于是,在允许灰色赋值器存在的算法,最坏的情况下,回收器只能将所有赋值器线程停止才能完成其跟对象的完整扫描,也就是我们所说的 STW。
-
-为了确保强弱三色不变性的并发指针更新操作,需要通过赋值器屏障技术来保证指针的读写操作一致。因此我们所说的 Go 中的写屏障、混合写屏障,其实是指赋值器的写屏障,赋值器的写屏障作为一种同步机制,使赋值器在进行指针写操作时,能够“通知”回收器,进而不会破坏弱三色不变性。
-
-有两种非常经典的写屏障:Dijkstra 插入屏障和 Yuasa 删除屏障。
-
-灰色赋值器的 Dijkstra 插入屏障的基本思想是避免满足条件 1:
-
-```go
-// 灰色赋值器 Dijkstra 插入屏障
-func DijkstraWritePointer(slot *unsafe.Pointer, ptr unsafe.Pointer) {
- shade(ptr)
- *slot = ptr
-}
-```
-
-为了防止黑色对象指向白色对象,应该假设 `*slot` 可能会变为黑色,为了确保 `ptr` 不会在被赋值到 `*slot` 前变为白色,`shade(ptr)` 会先将指针 `ptr` 标记为灰色,进而避免了条件 1。如图所示:
-
-
-
-Dijkstra 插入屏障的好处在于可以立刻开始并发标记。但存在两个缺点:
-
-1. 由于 Dijkstra 插入屏障的“保守”,在一次回收过程中可能会残留一部分对象没有回收成功,只有在下一个回收过程中才会被回收;
-2. 在标记阶段中,每次进行指针赋值操作时,都需要引入写屏障,这无疑会增加大量性能开销;为了避免造成性能问题,Go 团队在最终实现时,没有为所有栈上的指针写操作,启用写屏障,而是当发生栈上的写操作时,将栈标记为灰色,但此举产生了灰色赋值器,将会需要标记终止阶段 STW 时对这些栈进行重新扫描。
-
-另一种比较经典的写屏障是黑色赋值器的 Yuasa 删除屏障。其基本思想是避免满足条件 2:
-
-```go
-// 黑色赋值器 Yuasa 屏障
-func YuasaWritePointer(slot *unsafe.Pointer, ptr unsafe.Pointer) {
- shade(*slot)
- *slot = ptr
-}
-```
-
-为了防止丢失从灰色对象到白色对象的路径,应该假设 `*slot` 可能会变为黑色,为了确保 `ptr` 不会在被赋值到 `*slot` 前变为白色,`shade(*slot)` 会先将 `*slot` 标记为灰色,进而该写操作总是创造了一条灰色到灰色或者灰色到白色对象的路径,进而避免了条件 2。
-
-Yuasa 删除屏障的优势则在于不需要标记结束阶段的重新扫描,结束时候能够准确的回收所有需要回收的白色对象。缺陷是 Yuasa 删除屏障会拦截写操作,进而导致波面的退后,产生“冗余”的扫描:
-
-
-
-Go 在 1.8 的时候为了简化 GC 的流程,同时减少标记终止阶段的重扫成本,将 Dijkstra 插入屏障和 Yuasa 删除屏障进行混合,形成混合写屏障。该屏障提出时的基本思想是:**对正在被覆盖的对象进行着色,且如果当前栈未扫描完成,则同样对指针进行着色。**
-
-但在最终实现时原提案[4]中对 `ptr` 的着色还额外包含对执行栈的着色检查,但由于时间有限,并未完整实现过,所以混合写屏障在目前的实现伪代码是:
-
-```go
-// 混合写屏障
-func HybridWritePointerSimple(slot *unsafe.Pointer, ptr unsafe.Pointer) {
- shade(*slot)
- shade(ptr)
- *slot = ptr
-}
-```
-
-在这个实现中,如果无条件对引用双方进行着色,自然结合了 Dijkstra 和 Yuasa 写屏障的优势,但缺点也非常明显,因为着色成本是双倍的,而且编译器需要插入的代码也成倍增加,随之带来的结果就是编译后的二进制文件大小也进一步增加。为了针对写屏障的性能进行优化,Go 1.10 前后,Go 团队随后实现了批量写屏障机制。其基本想法是将需要着色的指针统一写入一个缓存,每当缓存满时统一对缓存中的所有 `ptr` 指针进行着色。
-
-# GC 的实现细节
-
-## 10. Go 语言中 GC 的流程是什么?
-
-当前版本的 Go 以 STW 为界限,可以将 GC 划分为五个阶段:
-
-| 阶段 | 说明 | 赋值器状态 |
-| :--------------: | :--------------------------------------------------------: | :--------: |
-| SweepTermination | 清扫终止阶段,为下一个阶段的并发标记做准备工作,启动写屏障 | STW |
-| Mark | 扫描标记阶段,与赋值器并发执行,写屏障开启 | 并发 |
-| MarkTermination | 标记终止阶段,保证一个周期内标记任务完成,停止写屏障 | STW |
-| GCoff | 内存清扫阶段,将需要回收的内存归还到堆中,写屏障关闭 | 并发 |
-| GCoff | 内存归还阶段,将过多的内存归还给操作系统,写屏障关闭 | 并发 |
-
-具体而言,各个阶段的触发函数分别为:
-
-
-
-## 11. 触发 GC 的时机是什么?
-
-Go 语言中对 GC 的触发时机存在两种形式:
-
-1. **主动触发**,通过调用 runtime.GC 来触发 GC,此调用阻塞式地等待当前 GC 运行完毕。
-
-2. **被动触发**,分为两种方式:
-
- - 使用系统监控,当超过两分钟没有产生任何 GC 时,强制触发 GC。
-
- - 使用步调(Pacing)算法,其核心思想是控制内存增长的比例。
-
-通过 `GOGC` 或者 `debug.SetGCPercent` 进行控制(他们控制的是同一个变量,即堆的增长率 $\rho$)。整个算法的设计考虑的是优化问题:如果设上一次 GC 完成时,内存的数量为 $H_m$(heap marked),估计需要触发 GC 时的堆大小 $H_T$(heap trigger),使得完成 GC 时候的目标堆大小 $H_g$(heap goal) 与实际完成时候的堆大小 $H_a$(heap actual)最为接近,即: $\min |H_g - H_a| = \min|(1+\rho)H_m - H_a|$。
-
-
-
-除此之外,步调算法还需要考虑 CPU 利用率的问题,显然我们不应该让垃圾回收器占用过多的 CPU,即不应该让每个负责执行用户 goroutine 的线程都在执行标记过程。理想情况下,在用户代码满载的时候,GC 的 CPU 使用率不应该超过 25%,即另一个优化问题:如果设 $u_g$为目标 CPU 使用率(goal utilization),而 $u_a$为实际 CPU 使用率(actual utilization),则 $\min|u_g - u_a|$。
-
-> 求解这两个优化问题的具体数学建模过程我们不在此做深入讨论,有兴趣的读者可以参考两个设计文档:Go 1.5 concurrent garbage collector pacing[5] 和 Separate soft and hard heap size goal[6]。
-
-计算 $H_T$ 的最终结论(从 Go 1.10 时开始 $h_t$ 增加了上界 $0.95 \rho$,从 Go 1.14 开始时 $h_t$ 增加了下界 0.6)是:
-
-- 设第 n 次触发 GC 时 (n > 1),估计得到的堆增长率为 $h_t^{(n)}$、运行过程中的实际堆增长率为 $h_a^{(n)}$,用户设置的增长率为 $\rho = \text{GOGC}/100$( $\rho > 0$)则第 $n+1$ 次出触发 GC 时候,估计的堆增长率为:
-
-$$
-h_t^{(n+1)} = h_t^{(n)} + 0.5 \left[ \frac{H_g^{(n)} - H_a^{(n)}}{H_a^{(n)}} - h_t^{(n)} - \frac{u_a^{(n)}}{u_g^{(n)}} \left( h_a^{(n)} - h_t^{(n)} \right) \right]
-$$
-
-- 特别的,$h_t^{(1)} = 7 / 8$,$u_a^{(1)} = 0.25$,$u_g^{(1)} = 0.3$。第一次触发 GC 时,如果当前的堆小于 $4\rho$ MB,则强制调整到 $4\rho$ MB 时触发 GC
-
-- 特别的,当 $h_t^{(n)}<0.6$时,将其调整为 $0.6$,当 $h_t^{(n)} > 0.95 \rho$ 时,将其设置为 $0.95 \rho$
-
-- 默认情况下,$\rho = 1$(即 GOGC = 100),第一次触发 GC 时强制设置触发第一次 GC 为 4MB,可以写如下程序进行验证:
-
-```go
-package main
-
-import (
- "os"
- "runtime"
- "runtime/trace"
- "sync/atomic"
-)
-
-var stop uint64
-
-// 通过对象 P 的释放状态,来确定 GC 是否已经完成
-func gcfinished() *int {
- p := 1
- runtime.SetFinalizer(&p, func(_ *int) {
- println("gc finished")
- atomic.StoreUint64(&stop, 1) // 通知停止分配
- })
- return &p
-}
-
-func allocate() {
- // 每次调用分配 0.25MB
- _ = make([]byte, int((1<<20)*0.25))
-}
-
-func main() {
- f, _ := os.Create("trace.out")
- defer f.Close()
- trace.Start(f)
- defer trace.Stop()
-
- gcfinished()
-
- // 当完成 GC 时停止分配
- for n := 1; atomic.LoadUint64(&stop) != 1; n++ {
- println("#allocate: ", n)
- allocate()
- }
- println("terminate")
-}
-```
-
-我们先来验证最简单的一种情况,即第一次触发 GC 时的堆大小:
-
-```
-$ go build -o main
-$ GODEBUG=gctrace=1 ./main
-#allocate: 1
-(...)
-#allocate: 20
-gc finished
-gc 1 @0.001s 3%: 0.016+0.23+0.019 ms clock, 0.20+0.11/0.060/0.13+0.22 ms cpu, 4->5->1 MB, 5 MB goal, 12 P
-scvg: 8 KB released
-scvg: inuse: 1, idle: 62, sys: 63, released: 58, consumed: 5 (MB)
-terminate
-```
-
-通过这一行数据我们可以看到:
-
-```
-gc 1 @0.001s 3%: 0.016+0.23+0.019 ms clock, 0.20+0.11/0.060/0.13+0.22 ms cpu, 4->5->1 MB, 5 MB goal, 12 P
-```
-
-1. 程序在完成第一次 GC 后便终止了程序,符合我们的设想
-2. 第一次 GC 开始时的堆大小为 4MB,符合我们的设想
-3. 当标记终止时,堆大小为 5MB,此后开始执行清扫,这时分配执行到第 20 次,即 20*0.25 = 5MB,符合我们的设想
-
-我们将分配次数调整到 50 次
-
-```go
-for n := 1; n < 50; n++ {
- println("#allocate: ", n)
- allocate()
-}
-```
-
-来验证第二次 GC 触发时是否满足公式所计算得到的值(为 GODEBUG 进一步设置 `gcpacertrace=1`):
-
-```
-$ go build -o main
-$ GODEBUG=gctrace=1,gcpacertrace=1 ./main
-#allocate: 1
-(...)
-
-pacer: H_m_prev=2236962 h_t=+8.750000e-001 H_T=4194304 h_a=+2.387451e+000 H_a=7577600 h_g=+1.442627e+000 H_g=5464064 u_a=+2.652227e-001 u_g=+3.000000e-001 W_a=152832 goalΔ=+5.676271e-001 actualΔ=+1.512451e+000 u_a/u_g=+8.840755e-001
-#allocate: 28
-gc 1 @0.001s 5%: 0.032+0.32+0.055 ms clock, 0.38+0.068/0.053/0.11+0.67 ms cpu, 4->7->3 MB, 5 MB goal, 12 P
-
-(...)
-#allocate: 37
-pacer: H_m_prev=3307736 h_t=+6.000000e-001 H_T=5292377 h_a=+7.949171e-001 H_a=5937112 h_g=+1.000000e+000 H_g=6615472 u_a=+2.658428e-001 u_g=+3.000000e-001 W_a=154240 goalΔ=+4.000000e-001 actualΔ=+1.949171e-001 u_a/u_g=+8.861428e-001
-#allocate: 38
-gc 2 @0.002s 9%: 0.017+0.26+0.16 ms clock, 0.20+0.079/0.058/0.12+1.9 ms cpu, 5->5->0 MB, 6 MB goal, 12 P
-```
-
-我们可以得到数据:
-
-- 第一次估计得到的堆增长率为 $h_t^{(1)} = 0.875$
-- 第一次的运行过程中的实际堆增长率为 $h_a^{(1)} = 0.2387451$
-- 第一次实际的堆大小为 $H_a^{(1)}=7577600$
-- 第一次目标的堆大小为 $H_g^{(1)}=5464064$
-- 第一次的 CPU 实际使用率为 $u_a^{(1)} = 0.2652227$
-- 第一次的 CPU 目标使用率为 $u_g^{(1)} = 0.3$
-
-我们据此计算第二次估计的堆增长率:
-
-$$
-\begin{align}
-h_t^{(2)} &= h_t^{(1)} + 0.5 \left[ \frac{H_g^{(1)} - H_a^{(1)}}{H_a^{(1)}} - h_t^{(1)} - \frac{u_a^{(1)}}{u_g^{(1)}} \left( h_a^{(1)} - h_t^{(1)} \right) \right] \\
-&= 0.875 + 0.5 \left[ \frac{5464064 - 7577600}{5464064} - 0.875 - \frac{0.2652227}{0.3} \left( 0.2387451 - 0.875 \right) \right] \\
-& \approx 0.52534543909 \\
-\end{align}
-$$
-
-因为 $0.52534543909 < 0.6\rho = 0.6$,因此下一次的触发率为 $h_t^{2} = 0.6$,与我们实际观察到的第二次 GC 的触发率 0.6 吻合。
-
-## 12. 如果内存分配速度超过了标记清除的速度怎么办?
-
-目前的 Go 实现中,当 GC 触发后,会首先进入并发标记的阶段。并发标记会设置一个标志,并在 mallocgc 调用时进行检查。当存在新的内存分配时,会暂停分配内存过快的那些 goroutine,并将其转去执行一些辅助标记(Mark Assist)的工作,从而达到放缓继续分配、辅助 GC 的标记工作的目的。
-
-编译器会分析用户代码,并在需要分配内存的位置,将申请内存的操作翻译为 `mallocgc` 调用,而 `mallocgc` 的实现决定了标记辅助的实现,其伪代码思路如下:
-
-```go
-func mallocgc(t typ.Type, size uint64) {
- if enableMarkAssist {
- // 进行标记辅助,此时用户代码没有得到执行
- (...)
- }
- // 执行内存分配
- (...)
-}
-```
-
-# GC 的优化问题
-
-## 13. GC 关注的指标有哪些?
-
-Go 的 GC 被设计为成比例触发、大部分工作与赋值器并发、不分代、无内存移动且会主动向操作系统归还申请的内存。因此最主要关注的、能够影响赋值器的性能指标有:
-
-- CPU 利用率:回收算法会在多大程度上拖慢程序?有时候,这个是通过回收占用的 CPU 时间与其它 CPU 时间的百分比来描述的。
-- GC 停顿时间:回收器会造成多长时间的停顿?目前的 GC 中需要考虑 STW 和 Mark Assist 两个部分可能造成的停顿。
-- GC 停顿频率:回收器造成的停顿频率是怎样的?目前的 GC 中需要考虑 STW 和 Mark Assist 两个部分可能造成的停顿。
-- GC 可扩展性:当堆内存变大时,垃圾回收器的性能如何?但大部分的程序可能并不一定关心这个问题。
-
-## 14. Go 的 GC 如何调优?
-
-Go 的 GC 被设计为极致简洁,与较为成熟的 Java GC 的数十个可控参数相比,严格意义上来讲,Go 可供用户调整的参数只有 GOGC 环境变量。当我们谈论 GC 调优时,通常是指减少用户代码对 GC 产生的压力,这一方面包含了减少用户代码分配内存的数量(即对程序的代码行为进行调优),另一方面包含了最小化 Go 的 GC 对 CPU 的使用率(即调整 GOGC)。
-
-GC 的调优是在特定场景下产生的,并非所有程序都需要针对 GC 进行调优。只有那些对执行延迟非常敏感、
-当 GC 的开销成为程序性能瓶颈的程序,才需要针对 GC 进行性能调优,几乎不存在于实际开发中 99% 的情况。
-除此之外,Go 的 GC 也仍然有一定的可改进的空间,也有部分 GC 造成的问题,目前仍属于 Open Problem。
-
-总的来说,我们可以在现在的开发中处理的有以下几种情况:
-
-1. 对停顿敏感:GC 过程中产生的长时间停顿、或由于需要执行 GC 而没有执行用户代码,导致需要立即执行的用户代码执行滞后。
-2. 对资源消耗敏感:对于频繁分配内存的应用而言,频繁分配内存增加 GC 的工作量,原本可以充分利用 CPU 的应用不得不频繁地执行垃圾回收,影响用户代码对 CPU 的利用率,进而影响用户代码的执行效率。
-
-从这两点来看,所谓 GC 调优的核心思想也就是充分的围绕上面的两点来展开:优化内存的申请速度,尽可能的少申请内存,复用已申请的内存。或者简单来说,不外乎这三个关键字:**控制、减少、复用**。
-
-我们将通过三个实际例子介绍如何定位 GC 的存在的问题,并一步一步进行性能调优。当然,在实际情况中问题远比这些例子要复杂,这里也只是讨论调优的核心思想,更多的时候也只能具体问题具体分析。
-
-### 例1:合理化内存分配的速度、提高赋值器的 CPU 利用率
-
-我们来看这样一个例子。在这个例子中,`concat` 函数负责拼接一些长度不确定的字符串。并且为了快速完成任务,出于某种原因,在两个嵌套的 for 循环中一口气创建了 800 个 goroutine。在 main 函数中,启动了一个 goroutine 并在程序结束前不断的触发 GC,并尝试输出 GC 的平均执行时间:
-
-```go
-package main
-
-import (
- "fmt"
- "os"
- "runtime"
- "runtime/trace"
- "sync/atomic"
- "time"
-)
-
-var (
- stop int32
- count int64
- sum time.Duration
-)
-
-func concat() {
- for n := 0; n < 100; n++ {
- for i := 0; i < 8; i++ {
- go func() {
- s := "Go GC"
- s += " " + "Hello"
- s += " " + "World"
- _ = s
- }()
- }
- }
-}
-
-func main() {
- f, _ := os.Create("trace.out")
- defer f.Close()
- trace.Start(f)
- defer trace.Stop()
-
- go func() {
- var t time.Time
- for atomic.LoadInt32(&stop) == 0 {
- t = time.Now()
- runtime.GC()
- sum += time.Since(t)
- count++
- }
- fmt.Printf("GC spend avg: %v\n", time.Duration(int64(sum)/count))
- }()
-
- concat()
- atomic.StoreInt32(&stop, 1)
-}
-```
-
-这个程序的执行结果是:
-
-```bash
-$ go build -o main
-$ ./main
-GC spend avg: 2.583421ms
-```
-
-GC 平均执行一次需要长达 2ms 的时间,我们再进一步观察 trace 的结果:
-
-
-
-程序的整个执行过程中仅执行了一次 GC,而且仅 Sweep STW 就耗费了超过 1 ms,非常反常。甚至查看赋值器 mutator 的 CPU 利用率,在整个 trace 尺度下连 40% 都不到:
-
-
-
-主要原因是什么呢?我们不妨查看 goroutine 的分析:
-
-
-
-在这个榜单中我们不难发现,goroutine 的执行时间占其生命周期总时间非常短的一部分,但大部分时间都花费在调度器的等待上了(蓝色的部分),说明同时创建大量 goroutine 对调度器产生的压力确实不小,我们不妨将这一产生速率减慢,一批一批地创建 goroutine:
-
-```go
-func concat() {
- wg := sync.WaitGroup{}
- for n := 0; n < 100; n++ {
- wg.Add(8)
- for i := 0; i < 8; i++ {
- go func() {
- s := "Go GC"
- s += " " + "Hello"
- s += " " + "World"
- _ = s
- wg.Done()
- }()
- }
- wg.Wait()
- }
-}
-```
-
-这时候我们再来看:
-
-```bash
-$ go build -o main
-$ ./main
-GC spend avg: 328.54µs
-```
-
-GC 的平均时间就降到 300 微秒了。这时的赋值器 CPU 使用率也提高到了 60%,相对来说就很可观了:
-
-
-
-当然,这个程序仍然有优化空间,例如我们其实没有必要等待很多 goroutine 同时执行完毕才去执行下一组 goroutine。而可以当一个 goroutine 执行完毕时,直接启动一个新的 goroutine,也就是 goroutine 池的使用。
-有兴趣的读者可以沿着这个思路进一步优化这个程序中赋值器对 CPU 的使用率。
-
-### 例2:降低并复用已经申请的内存
-
-我们通过一个非常简单的 Web 程序来说明复用内存的重要性。在这个程序中,每当产生一个 `/example2`
-的请求时,都会创建一段内存,并用于进行一些后续的工作。
-
-```go
-package main
-
-import (
- "fmt"
- "net/http"
- _ "net/http/pprof"
-)
-
-func newBuf() []byte {
- return make([]byte, 10<<20)
-}
-
-func main() {
- go func() {
- http.ListenAndServe("localhost:6060", nil)
- }()
-
- http.HandleFunc("/example2", func(w http.ResponseWriter, r *http.Request) {
- b := newBuf()
-
- // 模拟执行一些工作
- for idx := range b {
- b[idx] = 1
- }
-
- fmt.Fprintf(w, "done, %v", r.URL.Path[1:])
- })
- http.ListenAndServe(":8080", nil)
-}
-```
-
-为了进行性能分析,我们还额外创建了一个监听 6060 端口的 goroutine,用于使用 pprof 进行分析。
-我们先让服务器跑起来:
-
-```bash
-$ go build -o main
-$ ./main
-```
-
-我们这次使用 pprof 的 trace 来查看 GC 在此服务器中面对大量请求时候的状态,要使用 trace 可以通过访问 `/debug/pprof/trace` 路由来进行,其中 `seconds` 参数设置为 20s,并将 trace 的结果保存为 `trace.out`:
-
-```bash
-$ wget http://127.0.0.1:6060/debug/pprof/trace\?seconds\=20 -O trace.out
---2020-01-01 22:13:34-- http://127.0.0.1:6060/debug/pprof/trace?seconds=20
-Connecting to 127.0.0.1:6060... connected.
-HTTP request sent, awaiting response...
-```
-
-这时候我们使用一个压测工具 `ab`,来同时产生 500 个请求
-(`-n` 一共 500 个请求,`-c` 一个时刻执行请求的数量,每次 100 个并发请求):
-
-```bash
-$ ab -n 500 -c 100 http://127.0.0.1:8080/example2
-This is ApacheBench, Version 2.3 <$Revision: 1843412 $>
-Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
-Licensed to The Apache Software Foundation, http://www.apache.org/
-
-Benchmarking 127.0.0.1 (be patient)
-Completed 100 requests
-Completed 200 requests
-Completed 300 requests
-Completed 400 requests
-Completed 500 requests
-Finished 500 requests
-
-
-Server Software:
-Server Hostname: 127.0.0.1
-Server Port: 8080
-
-Document Path: /example2
-Document Length: 14 bytes
-
-Concurrency Level: 100
-Time taken for tests: 0.987 seconds
-Complete requests: 500
-Failed requests: 0
-Total transferred: 65500 bytes
-HTML transferred: 7000 bytes
-Requests per second: 506.63 [#/sec] (mean)
-Time per request: 197.382 [ms] (mean)
-Time per request: 1.974 [ms] (mean, across all concurrent requests)
-Transfer rate: 64.81 [Kbytes/sec] received
-
-Connection Times (ms)
- min mean[+/-sd] median max
-Connect: 0 1 1.1 0 7
-Processing: 13 179 77.5 170 456
-Waiting: 10 168 78.8 162 455
-Total: 14 180 77.3 171 458
-
-Percentage of the requests served within a certain time (ms)
- 50% 171
- 66% 203
- 75% 222
- 80% 239
- 90% 281
- 95% 335
- 98% 365
- 99% 400
- 100% 458 (longest request)
-```
-
-
-
-GC 反复被触发,一个显而易见的原因就是内存分配过多。我们可以通过 `go tool pprof` 来查看究竟是谁分配了大量内存(使用 web 指令来使用浏览器打开统计信息的可视化图形):
-
-```bash
-$ go tool pprof http://127.0.0.1:6060/debug/pprof/heap
-Fetching profile over HTTP from http://localhost:6060/debug/pprof/heap
-Saved profile in /Users/changkun/pprof/pprof.alloc_objects.alloc_space.inuse_o
-bjects.inuse_space.003.pb.gz
-Type: inuse_space
-Time: Jan 1, 2020 at 11:15pm (CET)
-Entering interactive mode (type "help" for commands, "o" for options)
-(pprof) web
-(pprof)
-```
-
-
-
-可见 `newBuf` 产生的申请的内存过多,现在我们使用 sync.Pool 来复用 `newBuf` 所产生的对象:
-
-```go
-package main
-
-import (
- "fmt"
- "net/http"
- _ "net/http/pprof"
- "sync"
-)
-
-// 使用 sync.Pool 复用需要的 buf
-var bufPool = sync.Pool{
- New: func() interface{} {
- return make([]byte, 10<<20)
- },
-}
-
-func main() {
- go func() {
- http.ListenAndServe("localhost:6060", nil)
- }()
- http.HandleFunc("/example2", func(w http.ResponseWriter, r *http.Request) {
- b := bufPool.Get().([]byte)
- for idx := range b {
- b[idx] = 0
- }
- fmt.Fprintf(w, "done, %v", r.URL.Path[1:])
- bufPool.Put(b)
- })
- http.ListenAndServe(":8080", nil)
-}
-```
-
-其中 ab 输出的统计结果为:
-
-```bash
-$ ab -n 500 -c 100 http://127.0.0.1:8080/example2
-This is ApacheBench, Version 2.3 <$Revision: 1843412 $>
-Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
-Licensed to The Apache Software Foundation, http://www.apache.org/
-
-Benchmarking 127.0.0.1 (be patient)
-Completed 100 requests
-Completed 200 requests
-Completed 300 requests
-Completed 400 requests
-Completed 500 requests
-Finished 500 requests
-
-
-Server Software:
-Server Hostname: 127.0.0.1
-Server Port: 8080
-
-Document Path: /example2
-Document Length: 14 bytes
-
-Concurrency Level: 100
-Time taken for tests: 0.427 seconds
-Complete requests: 500
-Failed requests: 0
-Total transferred: 65500 bytes
-HTML transferred: 7000 bytes
-Requests per second: 1171.32 [#/sec] (mean)
-Time per request: 85.374 [ms] (mean)
-Time per request: 0.854 [ms] (mean, across all concurrent requests)
-Transfer rate: 149.85 [Kbytes/sec] received
-
-Connection Times (ms)
- min mean[+/-sd] median max
-Connect: 0 1 1.4 1 9
-Processing: 5 75 48.2 66 211
-Waiting: 5 72 46.8 63 207
-Total: 5 77 48.2 67 211
-
-Percentage of the requests served within a certain time (ms)
- 50% 67
- 66% 89
- 75% 107
- 80% 122
- 90% 148
- 95% 167
- 98% 196
- 99% 204
- 100% 211 (longest request)
-```
-
-但从 `Requests per second` 每秒请求数来看,从原来的 506.63 变为 1171.32 得到了近乎一倍的提升。从 trace 的结果来看,GC 也没有频繁的被触发从而长期消耗 CPU 使用率:
-
-
-
-sync.Pool 是内存复用的一个最为显著的例子,从语言层面上还有很多类似的例子,例如在例 1 中,`concat` 函数可以预先分配一定长度的缓存,而后再通过 append 的方式将字符串存储到缓存中:
-
-```go
-func concat() {
- wg := sync.WaitGroup{}
- for n := 0; n < 100; n++ {
- wg.Add(8)
- for i := 0; i < 8; i++ {
- go func() {
- s := make([]byte, 0, 20)
- s = append(s, "Go GC"...)
- s = append(s, ' ')
- s = append(s, "Hello"...)
- s = append(s, ' ')
- s = append(s, "World"...)
- _ = string(s)
- wg.Done()
- }()
- }
- wg.Wait()
- }
-}
-```
-
-原因在于 `+` 运算符会随着字符串长度的增加而申请更多的内存,并将内容从原来的内存位置拷贝到新的内存位置,造成大量不必要的内存分配,先提前分配好足够的内存,再慢慢地填充,也是一种减少内存分配、复用内存形式的一种表现。
-
-### 例3:调整 GOGC
-
-我们已经知道了 GC 的触发原则是由步调算法来控制的,其关键在于估计下一次需要触发 GC 时,堆的大小。可想而知,如果我们在遇到海量请求的时,为了避免 GC 频繁触发,是否可以通过将 GOGC 的值设置得更大,让 GC 触发的时间变得更晚,从而减少其触发频率,进而增加用户代码对机器的使用率呢?答案是肯定的。
-
-我们可以非常简单粗暴的将 GOGC 调整为 1000,来执行上一个例子中未复用对象之前的程序:
-
-```bash
-$ GOGC=1000 ./main
-```
-
-这时我们再重新执行压测:
-
-```bash
-$ ab -n 500 -c 100 http://127.0.0.1:8080/example2
-This is ApacheBench, Version 2.3 <$Revision: 1843412 $>
-Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
-Licensed to The Apache Software Foundation, http://www.apache.org/
-
-Benchmarking 127.0.0.1 (be patient)
-Completed 100 requests
-Completed 200 requests
-Completed 300 requests
-Completed 400 requests
-Completed 500 requests
-Finished 500 requests
-
-
-Server Software:
-Server Hostname: 127.0.0.1
-Server Port: 8080
-
-Document Path: /example2
-Document Length: 14 bytes
-
-Concurrency Level: 100
-Time taken for tests: 0.923 seconds
-Complete requests: 500
-Failed requests: 0
-Total transferred: 65500 bytes
-HTML transferred: 7000 bytes
-Requests per second: 541.61 [#/sec] (mean)
-Time per request: 184.636 [ms] (mean)
-Time per request: 1.846 [ms] (mean, across all concurrent requests)
-Transfer rate: 69.29 [Kbytes/sec] received
-
-Connection Times (ms)
- min mean[+/-sd] median max
-Connect: 0 1 1.8 0 20
-Processing: 9 171 210.4 66 859
-Waiting: 5 158 199.6 62 813
-Total: 9 173 210.6 68 860
-
-Percentage of the requests served within a certain time (ms)
- 50% 68
- 66% 133
- 75% 198
- 80% 292
- 90% 566
- 95% 696
- 98% 723
- 99% 743
- 100% 860 (longest request)
-```
-
-可以看到,压测的结果得到了一定幅度的改善(`Requests per second` 从原来的 506.63 提高为了 541.61),
-并且 GC 的执行频率明显降低:
-
-
-
-在实际实践中可表现为需要紧急处理一些由 GC 带来的瓶颈时,人为将 GOGC 调大,加钱加内存,扛过这一段峰值流量时期。
-
-当然,这种做法其实是治标不治本,并没有从根本上解决内存分配过于频繁的问题,极端情况下,反而会由于 GOGC 太大而导致回收不及时而耗费更多的时间来清理产生的垃圾,这对时间不算敏感的应用还好,但对实时性要求较高的程序来说就是致命的打击了。
-
-因此这时更妥当的做法仍然是,定位问题的所在,并从代码层面上进行优化。
-
-### 小结
-
-通过上面的三个例子我们可以看到在 GC 调优过程中 `go tool pprof` 和 `go tool trace` 的强大作用是帮助我们快速定位 GC 导致瓶颈的具体位置,但这些例子中仅仅覆盖了其功能的很小一部分,我们也没有必要完整覆盖所有的功能,因为总是可以通过http pprof 官方文档[7]、runtime pprof官方文档[8]以及 trace 官方文档[9]来举一反三。
-
-现在我们来总结一下前面三个例子中的优化情况:
-
-1. 控制内存分配的速度,限制 goroutine 的数量,从而提高赋值器对 CPU 的利用率。
-2. 减少并复用内存,例如使用 sync.Pool 来复用需要频繁创建临时对象,例如提前分配足够的内存来降低多余的拷贝。
-3. 需要时,增大 GOGC 的值,降低 GC 的运行频率。
-
-这三种情况几乎涵盖了 GC 调优中的核心思路,虽然从语言上还有很多小技巧可说,但我们并不会在这里事无巨细的进行总结。实际情况也是千变万化,我们更应该着重于培养具体问题具体分析的能力。
-
-当然,我们还应该谨记 **过早优化是万恶之源**这一警语,在没有遇到应用的真正瓶颈时,将宝贵的时间分配在开发中其他优先级更高的任务上。
-
-## 15. Go 的垃圾回收器有哪些相关的 API?其作用分别是什么?
-
-在 Go 中存在数量极少的与 GC 相关的 API,它们是
-
-- runtime.GC:手动触发 GC
-- runtime.ReadMemStats:读取内存相关的统计信息,其中包含部分 GC 相关的统计信息
-- debug.FreeOSMemory:手动将内存归还给操作系统
-- debug.ReadGCStats:读取关于 GC 的相关统计信息
-- debug.SetGCPercent:设置 GOGC 调步变量
-- debug.SetMaxHeap(尚未发布[10]):设置 Go 程序堆的上限值
-
-# GC 的历史及演进
-
-## 16. Go 历史各个版本在 GC 方面的改进?
-
-- Go 1:串行三色标记清扫
-
-- Go 1.3:并行清扫,标记过程需要 STW,停顿时间在约几百毫秒
-
-- Go 1.5:并发标记清扫,停顿时间在一百毫秒以内
-
-- Go 1.6:使用 bitmap 来记录回收内存的位置,大幅优化垃圾回收器自身消耗的内存,停顿时间在十毫秒以内
-
-- Go 1.7:停顿时间控制在两毫秒以内
-
-- Go 1.8:混合写屏障,停顿时间在半个毫秒左右
-
-- Go 1.9:彻底移除了栈的重扫描过程
-
-- Go 1.12:整合了两个阶段的 Mark Termination,但引入了一个严重的 GC Bug 至今未修(见问题 20),尚无该 Bug 对 GC 性能影响的报告
-
-- Go 1.13:着手解决向操作系统归还内存的,提出了新的 Scavenger
-
-- Go 1.14:替代了仅存活了一个版本的 scavenger,全新的页分配器,优化分配内存过程的速率与现有的扩展性问题,并引入了异步抢占,解决了由于密集循环导致的 STW 时间过长的问题
-
-可以用下图直观地说明 GC 的演进历史:
-
-
-
-在 Go 1 刚发布时的版本中,甚至没有将 Mark-Sweep 的过程并行化,当需要进行垃圾回收时,所有的代码都必须进入 STW 的状态。而到了 Go 1.3 时,官方迅速地将清扫过程进行了并行化的处理,即仅在标记阶段进入 STW。
-
-这一想法很自然,因为并行化导致算法结果不一致的情况仅仅发生在标记阶段,而当时的垃圾回收器没有针对并行结果的一致性进行任何优化,因此才需要在标记阶段进入 STW。对于 Scavenger 而言,早期的版本中会有一个单独的线程来定期将多余的内存归还给操作系统。
-
-
-
-而到了 Go 1.5 后,Go 团队花费了相当大的力气,通过引入写屏障的机制来保证算法的一致性,才得以将整个 GC 控制在很小的 STW 内,而到了 1.8 时,由于新的混合屏障的出现,消除了对栈本身的重新扫描,STW 的时间进一步缩减。
-
-从这个时候开始,Scavenger 已经从独立线程中移除,并合并至系统监控这个独立的线程中,并周期性地向操作系统归还内存,但仍然会有内存溢出这种比较极端的情况出现,因为程序可能在短时间内应对突发性的内存申请需求时,内存还没来得及归还操作系统,导致堆不断向操作系统申请内存,从而出现内存溢出。
-
-
-
-到了 Go 1.13,定期归还操作系统的问题得以解决,Go 团队开始将周期性的 Scavenger 转化为可被调度的 goroutine,并将其与用户代码并发执行。而到了 Go 1.14,这一向操作系统归还内存的操作时间进一步得到缩减。
-
-## 17. Go GC 在演化过程中还存在哪些其他设计?为什么没有被采用?
-
-### 并发栈重扫
-
-正如我们前面所说,允许灰色赋值器存在的垃圾回收器需要引入重扫过程来保证算法的正确性,除了引入混合屏障来消除重扫这一过程外,有另一种做法可以提高重扫过程的性能,那就是将重扫的过程并发执行。然而这一方案[11]并没有得以实现,原因很简单:实现过程相比引入混合屏障而言十分复杂,而且引入混合屏障能够消除重扫这一过程,将简化垃圾回收的步骤。
-
-### ROC
-
-ROC 的全称是面向请求的回收器(Request Oriented Collector)[12],它其实也是分代 GC 的一种重新叙述。它提出了一个请求假设(Request Hypothesis):与一个完整请求、休眠 goroutine 所关联的对象比其他对象更容易死亡。这个假设听起来非常符合直觉,但在实现上,由于垃圾回收器必须确保是否有 goroutine 私有指针被写入公共对象,因此写屏障必须一直打开,这也就产生了该方法的致命缺点:昂贵的写屏障及其带来的缓存未命中,这也是这一设计最终没有被采用的主要原因。
-
-### 传统分代 GC
-
-在发现 ROC 性能不行之后,作为备选方案,Go 团队还尝试了实现传统的分代式 GC [13]。但最终同样发现分代假设并不适用于 Go 的运行栈机制,年轻代对象在栈上就已经死亡,扫描本就该回收的执行栈并没有为由于分代假设带来明显的性能提升。这也是这一设计最终没有被采用的主要原因。
-
-## 18. 目前提供 GC 的语言以及不提供 GC 的语言有哪些?GC 和 No GC 各自的优缺点是什么?
-
-从原理上而言,所有的语言都能够自行实现 GC。从语言诞生之初就提供 GC 的语言,例如:
-
-- Python
-- JavaScript
-- Java
-- Objective-C
-- Swift
-
-而不以 GC 为目标,被直接设计为手动管理内存、但可以自行实现 GC 的语言有:
-
-- C
-- C++
-
-也有一些语言可以在编译期,依靠编译器插入清理代码的方式,实现精准的清理,例如:
-
-- Rust
-
-垃圾回收使程序员无需手动处理内存释放,从而能够消除一些需要手动管理内存才会出现的运行时错误:
-
-1. 在仍然有指向内存区块的指针的情况下释放这块内存时,会产生悬挂指针,从而后续可能错误的访问已经用于他用的内存区域。
-2. 多重释放同一块申请的内存区域可能导致不可知的内存损坏。
-
-当然,垃圾回收也会伴随一些缺陷,这也就造就了没有 GC 的一些优势:
-
-1. 没有额外的性能开销
-2. 精准的手动内存管理,极致的利用机器的性能
-
-## 19. Go 对比 Java、V8 中 JavaScript 的 GC 性能如何?
-
-无论是 Java 还是 JavaScript 中的 GC 均为分代式 GC。分代式 GC 的一个核心假设就是分代假说:将对象依据存活时间分配到不同的区域,每次回收只回收其中的一个区域。
-
-### V8 的 GC
-
-在 V8 中主要将内存分为新生代和老生代。新生代中的对象为存活时间较短的对象,老生代中的对象为存活时间较长、常驻内存、占用内存较大的对象:
-
-1. 新生代中的对象主要通过副垃圾回收器进行回收。该回收过程是一种采用复制的方式实现的垃圾回收算法,它将堆内存一分为二,这两个空间中只有一个处于使用中,另一个则处于闲置状态。处于使用状态的空间称为 From 空间,处于闲置的空间称为 To 空间。分配对象时,先是在 From 空间中进行分配,当开始垃圾回收时,会检查 From 空间中的存活对象,并将这些存活对象复制到 To 空间中,而非存活对象占用的空间被释放。完成复制后,From 空间和 To 空间的角色互换。也就是通过将存活对象在两个空间中进行复制。
-2. 老生代则由主垃圾回收器负责。它实现的是标记清扫过程,但略有不同之处在于它还会在清扫完成后对内存碎片进行整理,进而是一种标记整理的回收器。
-
-### Java 的 GC
-
-Java 的 GC 称之为 G1,并将整个堆分为年轻代、老年代和永久代。包括四种不同的收集操作,从上往下的这几个阶段会选择性地执行,触发条件是用户的配置和实际代码行为的预测。
-
-1. 年轻代收集周期:只对年轻代对象进行收集与清理
-2. 老年代收集周期:只对老年代对象进行收集与清理
-3. 混合式收集周期:同时对年轻代和老年代进行收集与清理
-4. 完整 GC 周期:完整的对整个堆进行收集与清理
-
-在回收过程中,G1 会对停顿时间进行预测,竭尽所能地调整 GC 的策略从而达到用户代码通过系统参数(`-XX:MaxGCPauseMillis`)所配置的对停顿时间的要求。
-
-这四个周期的执行成本逐渐上升,优化得当的程序可以完全避免完整 GC 周期。
-
-### 性能比较
-
-在 Go、Java 和 V8 JavaScript 之间比较 GC 的性能本质上是一个不切实际的问题。如前面所说,垃圾回收器的设计权衡了很多方面的因素,同时还受语言自身设计的影响,因为语言的设计也直接影响了程序员编写代码的形式,也就自然影响了产生垃圾的方式。
-
-但总的来说,他们三者对垃圾回收的实现都需要 STW,并均已达到了用户代码几乎无法感知到的状态(据 Go GC 作者 Austin 宣称STW 小于 100 微秒 [14])。当然,随着 STW 的减少,垃圾回收器会增加 CPU 的使用率,这也是程序员在编写代码时需要手动进行优化的部分,即充分考虑内存分配的必要性,减少过多申请内存带给垃圾回收器的压力。
-
-## 20. 目前 Go 语言的 GC 还存在哪些问题?
-
-尽管 Go 团队宣称 STW 停顿时间得以优化到 100 微秒级别,但这本质上是一种取舍。原本的 STW 某种意义上来说其实转移到了可能导致用户代码停顿的几个位置;除此之外,由于运行时调度器的实现方式,同样对 GC 存在一定程度的影响。
-
-目前 Go 中的 GC 仍然存在以下问题:
-
-### 1. Mark Assist 停顿时间过长
-
-```go
-package main
-
-import (
- "fmt"
- "os"
- "runtime"
- "runtime/trace"
- "time"
-)
-
-const (
- windowSize = 200000
- msgCount = 1000000
-)
-
-var (
- best time.Duration = time.Second
- bestAt time.Time
- worst time.Duration
- worstAt time.Time
-
- start = time.Now()
-)
-
-func main() {
- f, _ := os.Create("trace.out")
- defer f.Close()
- trace.Start(f)
- defer trace.Stop()
-
- for i := 0; i < 5; i++ {
- measure()
- worst = 0
- best = time.Second
- runtime.GC()
- }
-}
-
-func measure() {
- var c channel
- for i := 0; i < msgCount; i++ {
- c.sendMsg(i)
- }
- fmt.Printf("Best send delay %v at %v, worst send delay: %v at %v. Wall clock: %v \n", best, bestAt.Sub(start), worst, worstAt.Sub(start), time.Since(start))
-}
-
-type channel [windowSize][]byte
-
-func (c *channel) sendMsg(id int) {
- start := time.Now()
-
- // 模拟发送
- (*c)[id%windowSize] = newMsg(id)
-
- end := time.Now()
- elapsed := end.Sub(start)
- if elapsed > worst {
- worst = elapsed
- worstAt = end
- }
- if elapsed < best {
- best = elapsed
- bestAt = end
- }
-}
-
-func newMsg(n int) []byte {
- m := make([]byte, 1024)
- for i := range m {
- m[i] = byte(n)
- }
- return m
-}
-```
-
-运行此程序我们可以得到类似下面的结果:
-
-```
-$ go run main.go
-
-Best send delay 330ns at 773.037956ms, worst send delay: 7.127915ms at 579.835487ms. Wall clock: 831.066632ms
-Best send delay 331ns at 873.672966ms, worst send delay: 6.731947ms at 1.023969626s. Wall clock: 1.515295559s
-Best send delay 330ns at 1.812141567s, worst send delay: 5.34028ms at 2.193858359s. Wall clock: 2.199921749s
-Best send delay 338ns at 2.722161771s, worst send delay: 7.479482ms at 2.665355216s. Wall clock: 2.920174197s
-Best send delay 337ns at 3.173649445s, worst send delay: 6.989577ms at 3.361716121s. Wall clock: 3.615079348s
-```
-
-
-在这个结果中,第一次的最坏延迟时间高达 7.12 毫秒,发生在程序运行 578 毫秒左右。通过 `go tool trace` 可以发现,这个时间段中,Mark Assist 执行了 7112312ns,约为 7.127915ms;可见,此时最坏情况下,标记辅助拖慢了用户代码的执行,是造成 7 毫秒延迟的原因。
-
-
-
-
-### 2. Sweep 停顿时间过长
-
-同样还是刚才的例子,如果我们仔细观察 Mark Assist 后发生的 Sweep 阶段,竟然对用户代码的影响长达约 30ms,根据调用栈信息可以看到,该 Sweep 过程发生在内存分配阶段:
-
-
-
-
-
-### 3. 由于 GC 算法的不正确性导致 GC 周期被迫重新执行
-
-此问题很难复现,但是一个已知的问题,根据 Go 团队的描述,能够在 1334 次构建中发生一次 [15],我们可以计算出其触发概率约为 0.0007496251874。虽然发生概率很低,但一旦发生,GC 需要被重新执行,非常不幸。
-
-
-
-### 4. 创建大量 Goroutine 后导致 GC 消耗更多的 CPU
-
-这个问题可以通过以下程序进行验证:
-
-```go
-func BenchmarkGCLargeGs(b *testing.B) {
- wg := sync.WaitGroup{}
-
- for ng := 100; ng <= 1000000; ng *= 10 {
- b.Run(fmt.Sprintf("#g-%d", ng), func(b *testing.B) {
- // 创建大量 goroutine,由于每次创建的 goroutine 会休眠
- // 从而运行时不会复用正在休眠的 goroutine,进而不断创建新的 g
- wg.Add(ng)
- for i := 0; i < ng; i++ {
- go func() {
- time.Sleep(100 * time.Millisecond)
- wg.Done()
- }()
- }
- wg.Wait()
-
- // 现运行一次 GC 来提供一致的内存环境
- runtime.GC()
-
- // 记录运行 b.N 次 GC 需要的时间
- b.ResetTimer()
- for i := 0; i < b.N; i++ {
- runtime.GC()
- }
- })
-
- }
-}
-```
-
-其结果可以通过如下指令来获得:
-
-```shell
-$ go test -bench=BenchmarkGCLargeGs -run=^$ -count=5 -v . | tee 4.txt
-$ benchstat 4.txt
-name time/op
-GCLargeGs/#g-100-12 192µs ± 5%
-GCLargeGs/#g-1000-12 331µs ± 1%
-GCLargeGs/#g-10000-12 1.22ms ± 1%
-GCLargeGs/#g-100000-12 10.9ms ± 3%
-GCLargeGs/#g-1000000-12 32.5ms ± 4%
-```
-
-这种情况通常发生于峰值流量后,大量 goroutine 由于任务等待被休眠,从而运行时不断创建新的 goroutine,
-旧的 goroutine 由于休眠未被销毁且得不到复用,导致 GC 需要扫描的执行栈越来越多,进而完成 GC 所需的时间越来越长。
-一个解决办法是使用 goroutine 池来限制创建的 goroutine 数量。
-
-
-
-# 总结
-
-GC 是一个复杂的系统工程,本文讨论的二十个问题尽管已经展现了一个相对全面的 Go GC。
-但它们仍然只是 GC 这一宏观问题的一小部分较为重要的内容,还有非常多的细枝末节、研究进展无法在有限的篇幅内完整讨论。
-
-从 Go 诞生之初,Go 团队就一直在对 GC 的表现进行实验与优化,但仍然有诸多未解决的公开问题,我们不妨对 GC 未来的改进拭目以待。
-
-# 进一步阅读的主要参考文献
-
-- [1] Ian Lance Taylor. Why golang garbage-collector not implement Generational and Compact gc? May 2017. https://groups.google.com/forum/#!msg/golang-nuts/KJiyv2mV2pU/wdBUH1mHCAAJ
-- [2] Go Team. `debug.GCStats`. Last access: Jan, 2020. https://golang.org/pkg/runtime/debug/#GCStats
-- [3] Go Team. `runtime.MemStats`. Last access: Jan, 2020. https://golang.org/pkg/runtime/#MemStats
-- [4] Austin Clements, Rick Hudson. Proposal: Eliminate STW stack re-scanning. Oct, 2016. https://github.com/golang/proposal/blob/master/design/17503-eliminate-rescan.md
-- [5] Austin Clements. Go 1.5 concurrent garbage collector pacing. Mar, 2015. https://docs.google.com/document/d/1wmjrocXIWTr1JxU-3EQBI6BK6KgtiFArkG47XK73xIQ/edit#
-- [6] Austin Clements. Proposal: Separate soft and hard heap size goal. Oct, 2017. https://github.com/golang/proposal/blob/master/design/14951-soft-heap-limit.md
-- [7] Go Team. HTTP pprof. Last access: Jan, 2020. https://golang.org/pkg/net/http/pprof/
-- [8] Go Team. Runtime pprof. Last access: Jan, 2020. https://golang.org/pkg/runtime/pprof/
-- [9] Go Team. Package trace. Last access: Jan, 2020. https://golang.org/pkg/runtime/trace/
-- [10] Caleb Spare. proposal: runtime: add a mechanism for specifying a minimum target heap size. Last access: Jan, 2020. https://github.com/golang/go/issues/23044
-- [11] Austin Clements, Rick Hudson. Proposal: Concurrent stack re-scanning. Oct, 2016. https://github.com/golang/proposal/blob/master/design/17505-concurrent-rescan.md
-- [12] Rick Hudson, Austin Clements. Request Oriented Collector (ROC) Algorithm. Jun, 2016. https://docs.google.com/document/d/1gCsFxXamW8RRvOe5hECz98Ftk-tcRRJcDFANj2VwCB0/edit
-- [13] Rick Hudson. runtime: constants and data structures for generational GC. Mar, 2019. https://go-review.googlesource.com/c/go/+/137476/12
-- [14] Austin Clements. Sub-millisecond GC pauses. Oct, 2016. https://groups.google.com/d/msg/golang-dev/Ab1sFeoZg_8/_DaL0E8fAwAJ
-- [15] Austin Clements. runtime: error message: P has cached GC work at end of mark termination. Nov, 2018. https://github.com/golang/go/issues/27993#issuecomment-441719687
-
-# 其他参考文献
-
-- [16] Dmitry Soshnikov. Writing a Memory Allocator. Feb. 2019. http://dmitrysoshnikov.com/compilers/writing-a-memory-allocator/#more-3590
-- [17] William Kennedy. Garbage Collection In Go : Part II - GC Traces. May 2019. https://www.ardanlabs.com/blog/2019/05/garbage-collection-in-go-part2-gctraces.html
-- [18] Rhys Hiltner. An Introduction to go tool trace. Last access: Jan, 2020. https://about.sourcegraph.com/go/an-introduction-to-go-tool-trace-rhys-hiltner
-- [19] 煎鱼. 用 GODEBUG 看 GC. Sep, 2019. https://segmentfault.com/a/1190000020255157
-- [20] 煎鱼. Go 大杀器之跟踪剖析 trace. Last access: Jan, 2020. https://eddycjy.gitbook.io/golang/di-9-ke-gong-ju/go-tool-trace
-
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..e380d57
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,6 @@
+all:
+ hugo
+s:
+ hugo server -D
+clean:
+ rm -rf public data
\ No newline at end of file
diff --git a/README.md b/README.md
index d38de43..c040a32 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,71 @@
-# 项目介绍
-- 个人博客:https://qcrao.com
+# [🌟Ads:我的小报童专栏《这一次彻底搞定 TODO 管理》已完结](https://xiaobot.net/p/MasteringTODOs)
-- 电子书地址:https://qcrao91.gitbook.io/go
+
-- 本项目地址:https://github.com/qcrao/Go-Questions
+# Go 程序员面试笔试宝典 
-`Go 语言`学习入门和进阶知识。以 `Go 语言`为突破口,从问题切入,掌握 Go 语言、后端相关的各种硬核知识。希望本项目能在职场表现、项目实战上助你一臂之力!
+_作者_: [饶全成](https://qcrao.com), [欧长坤](https://changkun.de), 楚秦 等编著
+_ISBN_: 978-7-111-70242-9
+_出版社_:[机械工业出版社](http://cmpbook.com)
-# 项目目录
-详见 [wiki](https://github.com/qcrao/Go-Questions/wiki)
+## 购买链接
-# 深度博客收录
+- [京东](https://item.jd.com/13128125.html)
+- [当当](http://product.dangdang.com/29390290.html)
+- [天猫](https://s.click.taobao.com/Nb3Q9Zu)
-只收录有深度的博客,请享用!
+## 关于本站
-|博客名|简介|地址|
-|---|---|---|
-|码农桃花源|本项目作者博客园|https://www.cnblogs.com/qcrao-2018|
-|欧神开源书《Go 语言原本》|Golang committers|https://changkun.de/golang|
-|No Headback|滴滴技术大神曹春晖|http://xargin.com|
-|面向信仰编程|给 kubernetes 提交 pr 的大神|https://draveness.me|
-|煎鱼的迷之博客|知其然,知其所以然|https://github.com/EDDYCJY/blog|
+这个站点包含了纸质版图书中的部分内容、对纸质版图书内容的部分更新以及勘误,
+我们推荐读者购买实体书籍配合本站共同使用。
+## 致读者
-# 学习交流
-你可以加我的微信一起交流:raoquancheng1991。
+因为 Go 语言在服务端的开发效率、服务性能有着不俗的表现,最近几年,Go 的热度越来越高。国内外很多大公司都在大规模地使用 Go。Google 就不用说了,它是 Go 语言诞生的地方,其他公司 如 Meta(Facebook)、uber、腾讯、字节跳动、知乎、脉脉等都在拥抱和转向 Go。用 Go 语言开发的著名开源项目也非常多,如 k8s、docker、etcd、consul,每个名字都是如雷贯耳。
-也可以关注公众号,和更多的人一起学习:
+随着市场对 Go 语言人才需求的不断增长,很多开发人员都从其他语言,如 PHP、C++、Java 等 转投 Go 语言的怀抱。因为 Go 语言自身的特点和优势,这些转型的开发人员也能写出性能不错的代码。但是,由于没有深入系统地学习 Go 的底层原理,在某些场景下,因为不懂底层原理,无法快速定位问题、无法进行性能优化。
-
+有些人说,语言并不重要,架构、技术选型这些才是根本。笔者觉得这个说法不完全对,架构、技术选型固然重要,但语言其实是开发人员每天都要打交道的东西,会用是远远不够的,只有用好、知其所以然才能更全面地发挥其威力。
+
+近一两年,笔者在中文世界论坛里发表了很多篇与 Go 源码阅读相关的文章,也是在写作本书的过程中做的功课。我通过看源码、做实验、请教大牛,对 Go 的“理解”逐渐加深。再去看很多文章就会感觉非常简单,为什么这些我都能掌握? 因为我研究过,我知道原理是什么,所以也知道你想要说什么。
+
+最后,无论你是面试官,还是求职者,这本书都能让你有所收获。另外,本书内容不仅仅是对面试有帮助,所有写 Go 的程序员都能从本书中有所收获,能让你的 Go 水平真正上升一个台阶。
+
+## 致谢
+
+在写作本书的过程中,我和本书的二作[欧长坤](https://changkun.de)有很多交流讨论,他对 Go 的理解非常深,他同时也是 Go Contributor,我们的交流和讨论让我对很多问题有了更深入的理解,
+非常感谢。我从 [Go 夜读社区](https://talkgo.org) 的分享中学到了很多东西。并且我本人也担任讲师,分享了多期 Go 相关的内容,很多观众都表示很有帮助。教是最好的学,我本人的收获是最多的。感谢 Go 夜读社区的发起者[杨文](https://maiyang.me)及 SIG 小组成员[煎鱼](https://github.com/EDDYCJY/blog)和[傲飞](https://aofei.com)。另外,我和 “Go 圈” 的很多博客作者也有很多交流,比如[曹大](http://xargin.com)、[Draven 大神](https://draveness.me)收获良多,在此一并感谢。这两年,我在 “码农桃花源” 发表了很多文章,得到了很多读者的肯定,这也是我能不断写作的动力,感谢你们。
+
+## 交流和勘误
+
+我们在这里维护了一份已出版内容的[勘误表](https://golang.design/go-questions/errata/),以帮助并消除读者在阅读过程中出现的困惑。
+读者还可以本书的 [GitHub 仓库](https://github.com/golang-design/go-questions)
+里讨论关于本书内容的问题,或报告并提交本书存在的错误。
+
+我们欢迎你在 GitHub 仓库上发起 [Issues](https://github.com/golang-design/go-questions/issues/new/choose) 或提交 [Pull Request](https://github.com/golang-design/go-questions/compare)。
+
+我们也欢迎你关注 “码农桃花源” 的公众号,和更多的人一起学习:
+
+
+
+## 作者的其他技术分享视频
+
+| 主题 | 作者 | 观看链接 |
+|:----|:------|:--------|
+| [Go defer 和逃逸分析](https://talkgo.org/t/topic/52) | 饶全成 | [YouTuBe](https://www.youtube.com/watch?v=-FtBBx44E3g&list=PLe5svQwVF1L5bNxB0smO8gNfAZQYWdIpI), [Bilibili](https://www.bilibili.com/video/BV1pb411v7m7) |
+| [Go map 源码阅读](https://talkgo.org/t/topic/63) | 饶全成 | [YouTuBe](https://www.youtube.com/watch?v=P2v3kvztWU0&list=PLe5svQwVF1L5bNxB0smO8gNfAZQYWdIpI), [Bilibili](https://www.bilibili.com/video/BV1Q4411W7MR) |
+| [Go Scheduler 源码阅读](https://talkgo.org/t/topic/97) | 饶全成 | [YouTuBe](https://www.youtube.com/watch?v=B-ozWjqnX24&list=PLe5svQwVF1L5bNxB0smO8gNfAZQYWdIpI), [Bilibili](https://www.bilibili.com/video/BV1SE411L7LU) |
+| [Go channel & select 源码阅读](https://talkgo.org/t/topic/75) | 欧长坤 | [YouTuBe](https://www.youtube.com/watch?v=d7fFCGGn0Wc&list=PLe5svQwVF1L5bNxB0smO8gNfAZQYWdIpI), [Bilibili](https://www.bilibili.com/video/BV1g4411R7p5) |
+| [CSP 理解顺序进程间通信](https://talkgo.org/t/topic/85) | 欧长坤 | [YouTuBe](https://www.youtube.com/watch?v=Z8ZpWVuEx8c&list=PLe5svQwVF1L5bNxB0smO8gNfAZQYWdIpI), [Bilibili](https://www.bilibili.com/video/BV1wE411q7G9) |
+| [真实世界中的 Go 程序并发错误](https://talkgo.org/t/topic/78) | 欧长坤 | [YouTuBe](https://www.youtube.com/watch?v=WZUii-Czaps&list=PLe5svQwVF1L5bNxB0smO8gNfAZQYWdIpI), [Bilibili](https://www.bilibili.com/video/BV1SJ411w7Ue) |
+| [Go 1.14 time.Timer 源码分析](https://talkgo.org/t/topic/93) | 欧长坤 | [YouTuBe](https://www.youtube.com/watch?v=XJx0eTP-y9I&list=PLe5svQwVF1L5bNxB0smO8gNfAZQYWdIpI), [Bilibili](https://www.bilibili.com/video/BV1nJ411j7bU) |
+| [Go 2 泛型预览](https://talkgo.org/t/topic/99) | 欧长坤 | [YouTuBe](https://youtu.be/E16Y6bI2S08), [Bilibili](https://www.bilibili.com/video/BV1k7411R7ya/) |
+| [对 Go 程序进行可靠的性能测试](https://talkgo.org/t/topic/102) | 欧长坤 | [YouTuBe](https://youtu.be/RXM9cDzWZME), [Bilibili](https://www.bilibili.com/video/BV1ae411x7dM) |
+| [Go 1.18 的泛型](https://talkgo.org/t/topic/3582) | 欧长坤 | [YouTuBe](https://youtu.be/ICcss3KKq_0), [Bilibili](https://www.bilibili.com/video/BV1244y1A7BM/) |
+
+## 许可
+
+
+
Go 程序员面试笔试宝典 由 饶全成, 欧长坤, 楚秦等
+采用署名-非商业性使用-禁止演绎 4.0 国际许可协议许可
+严禁任何商业行为使用或引用该文档的全部或部分内容,特授权 golang.design/go-questions 发布
+ {{- .Summary -}} + {{ if .Truncated }} + ... + {{ end }} +
++ {{- .Content -}} +
++ {{ .Inner | markdownify }} +diff --git a/themes/book/layouts/shortcodes/katex.html b/themes/book/layouts/shortcodes/katex.html new file mode 100644 index 0000000..b255cb8 --- /dev/null +++ b/themes/book/layouts/shortcodes/katex.html @@ -0,0 +1,13 @@ +{{- if not (.Page.Scratch.Get "katex") -}} + + + + +{{- .Page.Scratch.Set "katex" true -}} +{{- end -}} + + + {{ cond (in .Params "display") "\\[" "\\(" -}} + {{- trim .Inner "\n" -}} + {{- cond (in .Params "display") "\\]" "\\)" }} + diff --git a/themes/book/layouts/shortcodes/mermaid.html b/themes/book/layouts/shortcodes/mermaid.html new file mode 100644 index 0000000..ff90335 --- /dev/null +++ b/themes/book/layouts/shortcodes/mermaid.html @@ -0,0 +1,12 @@ +{{ if not (.Page.Scratch.Get "mermaid") }} + + +{{ with resources.Get "mermaid.json" }} + +{{ end }} +{{ .Page.Scratch.Set "mermaid" true }} +{{ end }} + +
+ {{- .Inner -}} +
diff --git a/themes/book/layouts/shortcodes/section.html b/themes/book/layouts/shortcodes/section.html new file mode 100644 index 0000000..21d2e75 --- /dev/null +++ b/themes/book/layouts/shortcodes/section.html @@ -0,0 +1,10 @@ ++ {{- .Summary -}} + {{ if .Truncated }} + ... + {{ end }} +
+h&&(l=0),l=l||0,g=l+c,g 0&&(e="."===(e=t)?null:e),e};Qt({type:"genfrac",names:["\\genfrac"],props:{numArgs:6,greediness:6,argTypes:["math","math","size","text","math","math"]},handler:function(t,e){var r=t.parser,a=e[4],n=e[5],i=Vt(e[0],"atom");i&&(i=Ut(e[0],"open"));var o=i?Lr(i.text):null,s=Vt(e[1],"atom");s&&(s=Ut(e[1],"close"));var h,l=s?Lr(s.text):null,m=Ft(e[2],"size"),c=null;h=!!m.isBlank||(c=m.value).number>0;var u="auto",p=Vt(e[3],"ordgroup");if(p){if(p.body.length>0){var d=Ft(p.body[0],"textord");u=Er[Number(d.text)]}}else p=Ft(e[3],"textord"),u=Er[Number(p.text)];return{type:"genfrac",mode:r.mode,numer:a,denom:n,continued:!1,hasBarLine:h,barSize:c,leftDelim:o,rightDelim:l,size:u}},htmlBuilder:Rr,mathmlBuilder:Or}),Qt({type:"infix",names:["\\above"],props:{numArgs:1,argTypes:["size"],infix:!0},handler:function(t,e){var r=t.parser,a=(t.funcName,t.token);return{type:"infix",mode:r.mode,replaceWith:"\\\\abovefrac",size:Ft(e[0],"size").value,token:a}}}),Qt({type:"genfrac",names:["\\\\abovefrac"],props:{numArgs:3,argTypes:["math","size","math"]},handler:function(t,e){var r=t.parser,a=(t.funcName,e[0]),n=function(t){if(!t)throw new Error("Expected non-null, but got "+String(t));return t}(Ft(e[1],"infix").size),i=e[2],o=n.number>0;return{type:"genfrac",mode:r.mode,numer:a,denom:i,continued:!1,hasBarLine:o,barSize:n,leftDelim:null,rightDelim:null,size:"auto"}},htmlBuilder:Rr,mathmlBuilder:Or});var Hr=function(t,e){var r,a,n=e.style,i=Vt(t,"supsub");i?(r=i.sup?ue(i.sup,e.havingStyle(n.sup()),e):ue(i.sub,e.havingStyle(n.sub()),e),a=Ft(i.base,"horizBrace")):a=Ft(t,"horizBrace");var o,s=ue(a.base,e.havingBaseStyle(w.DISPLAY)),h=Oe(a,e);if(a.isOver?(o=Dt.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:s},{type:"kern",size:.1},{type:"elem",elem:h}]},e)).children[0].children[0].children[1].classes.push("svg-align"):(o=Dt.makeVList({positionType:"bottom",positionData:s.depth+.1+h.height,children:[{type:"elem",elem:h},{type:"kern",size:.1},{type:"elem",elem:s}]},e)).children[0].children[0].children[0].classes.push("svg-align"),r){var l=Dt.makeSpan(["mord",a.isOver?"mover":"munder"],[o],e);o=a.isOver?Dt.makeVList({positionType:"firstBaseline",children:[{type:"elem",elem:l},{type:"kern",size:.2},{type:"elem",elem:r}]},e):Dt.makeVList({positionType:"bottom",positionData:l.depth+.2+r.height+r.depth,children:[{type:"elem",elem:r},{type:"kern",size:.2},{type:"elem",elem:l}]},e)}return Dt.makeSpan(["mord",a.isOver?"mover":"munder"],[o],e)};Qt({type:"horizBrace",names:["\\overbrace","\\underbrace"],props:{numArgs:1},handler:function(t,e){var r=t.parser,a=t.funcName;return{type:"horizBrace",mode:r.mode,label:a,isOver:/^\\over/.test(a),base:e[0]}},htmlBuilder:Hr,mathmlBuilder:function(t,e){var r=Re(t.label);return new ve.MathNode(t.isOver?"mover":"munder",[Me(t.base,e),r])}}),Qt({type:"href",names:["\\href"],props:{numArgs:2,argTypes:["url","original"],allowedInText:!0},handler:function(t,e){var r=t.parser,a=e[1],n=Ft(e[0],"url").url;return r.settings.isTrusted({command:"\\href",url:n})?{type:"href",mode:r.mode,href:n,body:ee(a)}:r.formatUnsupportedCmd("\\href")},htmlBuilder:function(t,e){var r=se(t.body,e,!1);return Dt.makeAnchor(t.href,[],r,e)},mathmlBuilder:function(t,e){var r=Se(t.body,e);return r instanceof ge||(r=new ge("mrow",[r])),r.setAttribute("href",t.href),r}}),Qt({type:"href",names:["\\url"],props:{numArgs:1,argTypes:["url"],allowedInText:!0},handler:function(t,e){var r=t.parser,a=Ft(e[0],"url").url;if(!r.settings.isTrusted({command:"\\url",url:a}))return r.formatUnsupportedCmd("\\url");for(var n=[],i=0;i >1)+f+t+w+C.slice(T);break;default:t=C+f+t+w}return s(t)}return y=void 0===y?6:/[gprs]/.test(m)?Math.max(1,Math.min(21,y)):Math.max(0,Math.min(20,y)),w.toString=function(){return t+""},w}return{format:h,formatPrefix:function(t,e){var n=h(((t=Hs(t)).type="f",t)),r=3*Math.max(-8,Math.min(8,Math.floor($s(e)/3))),i=Math.pow(10,-r),a=ec[8+r/3];return function(t){return n(i*t)+a}}}};function rc(t){return qs=nc(t),Xs=qs.format,Zs=qs.formatPrefix,qs}rc({decimal:".",thousands:",",grouping:[3],currency:["$",""],minus:"-"});var ic=function(t){return Math.max(0,-$s(Math.abs(t)))},ac=function(t,e){return Math.max(0,3*Math.max(-8,Math.min(8,Math.floor($s(e)/3)))-$s(Math.abs(t)))},oc=function(t,e){return t=Math.abs(t),e=Math.abs(e)-t,Math.max(0,$s(e)-$s(t))+1},sc=function(){return new cc};function cc(){this.reset()}cc.prototype={constructor:cc,reset:function(){this.s=this.t=0},add:function(t){lc(uc,t,this.t),lc(this,uc.s,this.s),this.s?this.t+=uc.t:this.s=uc.t},valueOf:function(){return this.s}};var uc=new cc;function lc(t,e,n){var r=t.s=e+n,i=r-e,a=r-i;t.t=e-a+(n-i)}var hc=Math.PI,fc=hc/2,dc=hc/4,pc=2*hc,gc=180/hc,yc=hc/180,vc=Math.abs,mc=Math.atan,bc=Math.atan2,xc=Math.cos,_c=Math.ceil,kc=Math.exp,wc=(Math.floor,Math.log),Ec=Math.pow,Tc=Math.sin,Cc=Math.sign||function(t){return t>0?1:t<0?-1:0},Ac=Math.sqrt,Sc=Math.tan;function Mc(t){return t>1?0:t<-1?hc:Math.acos(t)}function Oc(t){return t>1?fc:t<-1?-fc:Math.asin(t)}function Dc(t){return(t=Tc(t/2))*t}function Nc(){}function Bc(t,e){t&&Pc.hasOwnProperty(t.type)&&Pc[t.type](t,e)}var Lc={Feature:function(t,e){Bc(t.geometry,e)},FeatureCollection:function(t,e){for(var n=t.features,r=-1,i=n.length;++r=0?1:-1,i=r*n,a=xc(e=(e*=yc)/2+dc),o=Tc(e),s=Uc*o,c=zc*a+s*xc(i),u=s*r*Tc(i);Wc.add(bc(u,c)),Yc=t,zc=a,Uc=o}var Jc=function(t){return Hc.reset(),$c(t,Vc),2*Hc};function Kc(t){return[bc(t[1],t[0]),Oc(t[2])]}function Qc(t){var e=t[0],n=t[1],r=xc(n);return[r*xc(e),r*Tc(e),Tc(n)]}function tu(t,e){return t[0]*e[0]+t[1]*e[1]+t[2]*e[2]}function eu(t,e){return[t[1]*e[2]-t[2]*e[1],t[2]*e[0]-t[0]*e[2],t[0]*e[1]-t[1]*e[0]]}function nu(t,e){t[0]+=e[0],t[1]+=e[1],t[2]+=e[2]}function ru(t,e){return[t[0]*e,t[1]*e,t[2]*e]}function iu(t){var e=Ac(t[0]*t[0]+t[1]*t[1]+t[2]*t[2]);t[0]/=e,t[1]/=e,t[2]/=e}var au,ou,su,cu,uu,lu,hu,fu,du,pu,gu=sc(),yu={point:vu,lineStart:bu,lineEnd:xu,polygonStart:function(){yu.point=_u,yu.lineStart=ku,yu.lineEnd=wu,gu.reset(),Vc.polygonStart()},polygonEnd:function(){Vc.polygonEnd(),yu.point=vu,yu.lineStart=bu,yu.lineEnd=xu,Wc<0?(au=-(su=180),ou=-(cu=90)):gu>1e-6?cu=90:gu<-1e-6&&(ou=-90),pu[0]=au,pu[1]=su},sphere:function(){au=-(su=180),ou=-(cu=90)}};function vu(t,e){du.push(pu=[au=t,su=t]),e >>1;u[g]"},t}(),O={"\xee":"\u0131\u0302","\xef":"\u0131\u0308","\xed":"\u0131\u0301","\xec":"\u0131\u0300"},E=function(){function t(t,e,r,a,n,i,o,s){this.text=void 0,this.height=void 0,this.depth=void 0,this.italic=void 0,this.skew=void 0,this.width=void 0,this.maxFontSize=void 0,this.classes=void 0,this.style=void 0,this.text=t,this.height=e||0,this.depth=r||0,this.italic=a||0,this.skew=n||0,this.width=i||0,this.classes=o||[],this.style=s||{},this.maxFontSize=0;var h=function(t){for(var e=0;e
=s)){var P=void 0;(a>0||t.hskipBeforeAndAfter)&&0!==(P=c.deflt(O.pregap,p))&&((C=Dt.makeSpan(["arraycolsep"],[])).style.width=P+"em",R.push(C));var D=[];for(r=0;r0?3*c:7*c,d=e.fontMetrics().denom1):(m>0?(u=e.fontMetrics().num2,p=c):(u=e.fontMetrics().num3,p=3*c),d=e.fontMetrics().denom2),l){var y=e.fontMetrics().axisHeight;u-o.depth-(y+.5*m)0&&(u+=M,p-=M)}var z=[{type:"elem",elem:n,shift:p,marginRight:b,marginLeft:y},{type:"elem",elem:a,shift:-u,marginRight:b}];x=Dt.makeVList({positionType:"individualShift",children:z},e)}else if(n){p=Math.max(p,m.sub1,n.height-.8*m.xHeight);var A=[{type:"elem",elem:n,marginLeft:y,marginRight:b}];x=Dt.makeVList({positionType:"shift",positionData:p,children:A},e)}else{if(!a)throw new Error("supsub must have either sup or sub.");u=Math.max(u,i,a.depth+.25*m.xHeight),x=Dt.makeVList({positionType:"shift",positionData:-u,children:[{type:"elem",elem:a,marginRight:b}]},e)}var T=me(l,"right")||"mord";return Dt.makeSpan([T],[l,Dt.makeSpan(["msupsub"],[x])],e)},mathmlBuilder:function(t,e){var r,a=!1,n=Vt(t.base,"horizBrace");n&&!!t.sup===n.isOver&&(a=!0,r=n.isOver),!t.base||"op"!==t.base.type&&"operatorname"!==t.base.type||(t.base.parentIsSupSub=!0);var i,o=[Me(t.base,e)];if(t.sub&&o.push(Me(t.sub,e)),t.sup&&o.push(Me(t.sup,e)),a)i=r?"mover":"munder";else if(t.sub)if(t.sup){var s=t.base;i=s&&"op"===s.type&&s.limits&&e.style===w.DISPLAY?"munderover":s&&"operatorname"===s.type&&s.alwaysHandleSupSub&&(e.style===w.DISPLAY||s.limits)?"munderover":"msubsup"}else{var h=t.base;i=h&&"op"===h.type&&h.limits&&(e.style===w.DISPLAY||h.alwaysHandleSupSub)?"munder":h&&"operatorname"===h.type&&h.alwaysHandleSupSub&&(h.limits||e.style===w.DISPLAY)?"munder":"msub"}else{var l=t.base;i=l&&"op"===l.type&&l.limits&&(e.style===w.DISPLAY||l.alwaysHandleSupSub)?"mover":l&&"operatorname"===l.type&&l.alwaysHandleSupSub&&(l.limits||e.style===w.DISPLAY)?"mover":"msup"}return new ve.MathNode(i,o)}}),te({type:"atom",htmlBuilder:function(t,e){return Dt.mathsym(t.text,t.mode,e,["m"+t.family])},mathmlBuilder:function(t,e){var r=new ve.MathNode("mo",[be(t.text,t.mode)]);if("bin"===t.family){var a=we(t,e);"bold-italic"===a&&r.setAttribute("mathvariant",a)}else"punct"===t.family?r.setAttribute("separator","true"):"open"!==t.family&&"close"!==t.family||r.setAttribute("stretchy","false");return r}});var Zr={mi:"italic",mn:"normal",mtext:"normal"};te({type:"mathord",htmlBuilder:function(t,e){return Dt.makeOrd(t,e,"mathord")},mathmlBuilder:function(t,e){var r=new ve.MathNode("mi",[be(t.text,t.mode,e)]),a=we(t,e)||"italic";return a!==Zr[r.type]&&r.setAttribute("mathvariant",a),r}}),te({type:"textord",htmlBuilder:function(t,e){return Dt.makeOrd(t,e,"textord")},mathmlBuilder:function(t,e){var r,a=be(t.text,t.mode,e),n=we(t,e)||"normal";return r="text"===t.mode?new ve.MathNode("mtext",[a]):/[0-9]/.test(t.text)?new ve.MathNode("mn",[a]):"\\prime"===t.text?new ve.MathNode("mo",[a]):new ve.MathNode("mi",[a]),n!==Zr[r.type]&&r.setAttribute("mathvariant",n),r}});var Kr={"\\nobreak":"nobreak","\\allowbreak":"allowbreak"},Jr={" ":{},"\\ ":{},"~":{className:"nobreak"},"\\space":{},"\\nobreakspace":{className:"nobreak"}};te({type:"spacing",htmlBuilder:function(t,e){if(Jr.hasOwnProperty(t.text)){var r=Jr[t.text].className||"";if("text"===t.mode){var a=Dt.makeOrd(t,e,"textord");return a.classes.push(r),a}return Dt.makeSpan(["mspace",r],[Dt.mathsym(t.text,t.mode,e)],e)}if(Kr.hasOwnProperty(t.text))return Dt.makeSpan(["mspace",Kr[t.text]],[],e);throw new o('Unknown type of space "'+t.text+'"')},mathmlBuilder:function(t,e){if(!Jr.hasOwnProperty(t.text)){if(Kr.hasOwnProperty(t.text))return new ve.MathNode("mspace");throw new o('Unknown type of space "'+t.text+'"')}return new ve.MathNode("mtext",[new ve.TextNode("\xa0")])}});var Qr=function(){var t=new ve.MathNode("mtd",[]);return t.setAttribute("width","50%"),t};te({type:"tag",mathmlBuilder:function(t,e){var r=new ve.MathNode("mtable",[new ve.MathNode("mtr",[Qr(),new ve.MathNode("mtd",[Se(t.body,e)]),Qr(),new ve.MathNode("mtd",[Se(t.tag,e)])])]);return r.setAttribute("width","100%"),r}});var ta={"\\text":void 0,"\\textrm":"textrm","\\textsf":"textsf","\\texttt":"texttt","\\textnormal":"textrm"},ea={"\\textbf":"textbf","\\textmd":"textmd"},ra={"\\textit":"textit","\\textup":"textup"},aa=function(t,e){var r=t.font;return r?ta[r]?e.withTextFontFamily(ta[r]):ea[r]?e.withTextFontWeight(ea[r]):e.withTextFontShape(ra[r]):e};Qt({type:"text",names:["\\text","\\textrm","\\textsf","\\texttt","\\textnormal","\\textbf","\\textmd","\\textit","\\textup"],props:{numArgs:1,argTypes:["text"],greediness:2,allowedInText:!0},handler:function(t,e){var r=t.parser,a=t.funcName,n=e[0];return{type:"text",mode:r.mode,body:ee(n),font:a}},htmlBuilder:function(t,e){var r=aa(t,e),a=se(t.body,r,!0);return Dt.makeSpan(["mord","text"],Dt.tryCombineChars(a),r)},mathmlBuilder:function(t,e){var r=aa(t,e);return Se(t.body,r)}}),Qt({type:"underline",names:["\\underline"],props:{numArgs:1,allowedInText:!0},handler:function(t,e){return{type:"underline",mode:t.parser.mode,body:e[0]}},htmlBuilder:function(t,e){var r=ue(t.body,e),a=Dt.makeLineSpan("underline-line",e),n=e.fontMetrics().defaultRuleThickness,i=Dt.makeVList({positionType:"top",positionData:r.height,children:[{type:"kern",size:n},{type:"elem",elem:a},{type:"kern",size:3*n},{type:"elem",elem:r}]},e);return Dt.makeSpan(["mord","underline"],[i],e)},mathmlBuilder:function(t,e){var r=new ve.MathNode("mo",[new ve.TextNode("\u203e")]);r.setAttribute("stretchy","true");var a=new ve.MathNode("munder",[Me(t.body,e),r]);return a.setAttribute("accentunder","true"),a}}),Qt({type:"verb",names:["\\verb"],props:{numArgs:0,allowedInText:!0},handler:function(t,e,r){throw new o("\\verb ended by end of line instead of matching delimiter")},htmlBuilder:function(t,e){for(var r=na(t),a=[],n=e.havingStyle(e.style.text()),i=0;ie?1:t>=e?0:NaN},i=function(t){var e;return 1===t.length&&(e=t,t=function(t,n){return r(e(t),n)}),{left:function(e,n,r,i){for(null==r&&(r=0),null==i&&(i=e.length);r>>1;t(e[a],n)<0?r=a+1:i=a}return r},right:function(e,n,r,i){for(null==r&&(r=0),null==i&&(i=e.length);r>>1;t(e[a],n)>0?i=a:r=a+1}return r}}};var a=i(r),o=a.right,s=a.left,c=o,u=function(t,e){null==e&&(e=l);for(var n=0,r=t.length-1,i=t[0],a=new Array(r<0?0:r);ncu&&(cu=e)),u?t0?r=A(s=Math.floor(s/r)*r,c=Math.ceil(c/r)*r,n):r<0&&(r=A(s=Math.ceil(s*r)/r,c=Math.floor(c*r)/r,n)),r>0?(i[a]=Math.floor(s/r)*r,i[o]=Math.ceil(c/r)*r,e(i)):r<0&&(i[a]=Math.ceil(s*r)/r,i[o]=Math.floor(c*r)/r,e(i)),t},t}function sg(){var t=ig(Jp,Jp);return t.copy=function(){return ng(t,sg())},Rp.apply(t,arguments),og(t)}function cg(t){var e;function n(t){return isNaN(t=+t)?e:t}return n.invert=n,n.domain=n.range=function(e){return arguments.length?(t=Up.call(e,Xp),n):t.slice()},n.unknown=function(t){return arguments.length?(e=t,n):e},n.copy=function(){return cg(t).unknown(e)},t=arguments.length?Up.call(t,Xp):[0,1],og(n)}var ug=function(t,e){var n,r=0,i=(t=t.slice()).length-1,a=t[r],o=t[i];return o0){for(;fc)break;g.push(h)}}else g=C(f,d,Math.min(d-f,p)).map(n);return r?g.reverse():g},r.tickFormat=function(t,i){if(null==i&&(i=10===a?".0e":","),"function"!=typeof i&&(i=Xs(i)),t===1/0)return i;null==t&&(t=10);var o=Math.max(1,a*t/r.ticks().length);return function(t){var r=t/n(Math.round(e(t)));return r*a=c)return-1;if(37===(i=e.charCodeAt(o++))){if(i=e.charAt(o++),!(a=_[i in Vy?e.charAt(o++):i])||(r=a(t,n,r))<0)return-1}else if(i!=n.charCodeAt(r++))return-1}return r}return(b.x=k(n,b),b.X=k(r,b),b.c=k(e,b),x.x=k(n,x),x.X=k(r,x),x.c=k(e,x),{format:function(t){var e=k(t+="",b);return e.toString=function(){return t},e},parse:function(t){var e=w(t+="",!1);return e.toString=function(){return t},e},utcFormat:function(t){var e=k(t+="",x);return e.toString=function(){return t},e},utcParse:function(t){var e=w(t+="",!0);return e.toString=function(){return t},e}})}var zy,Uy,$y,Wy,Hy,Vy={"-":"",_:" ",0:"0"},Gy=/^\s*\d+/,qy=/^%/,Xy=/[\\^$*+?|[\]().{}]/g;function Zy(t,e,n){var r=t<0?"-":"",i=(r?-t:t)+"",a=i.length;return r+(ah&&S.push("'"+this.terminals_[T]+"'");O=p.showPosition?"Parse error on line "+(c+1)+":\n"+p.showPosition()+"\nExpecting "+S.join(", ")+", got '"+(this.terminals_[x]||x)+"'":"Parse error on line "+(c+1)+": Unexpected "+(x==f?"end of input":"'"+(this.terminals_[x]||x)+"'"),this.parseError(O,{text:p.match,token:this.terminals_[x]||x,line:p.yylineno,loc:v,expected:S})}if(w[0]instanceof Array&&w.length>1)throw new Error("Parse Error: multiple actions possible at state: "+k+", token: "+x);switch(w[0]){case 1:n.push(x),i.push(p.yytext),a.push(p.yylloc),n.push(w[1]),x=null,_?(x=_,_=null):(u=p.yyleng,s=p.yytext,c=p.yylineno,v=p.yylloc,l>0&&l--);break;case 2:if(C=this.productions_[w[1]][1],M.$=i[i.length-C],M._$={first_line:a[a.length-(C||1)].first_line,last_line:a[a.length-1].last_line,first_column:a[a.length-(C||1)].first_column,last_column:a[a.length-1].last_column},m&&(M._$.range=[a[a.length-(C||1)].range[0],a[a.length-1].range[1]]),void 0!==(E=this.performAction.apply(M,[s,u,c,g.yy,w[1],i,a].concat(d))))return E;C&&(n=n.slice(0,-1*C*2),i=i.slice(0,-1*C),a=a.slice(0,-1*C)),n.push(this.productions_[w[1]][0]),i.push(M.$),a.push(M._$),A=o[n[n.length-2]][n[n.length-1]],n.push(A);break;case 3:return!0}}return!0}},M={EOF:1,parseError:function(t,e){if(!this.yy.parser)throw new Error(t);this.yy.parser.parseError(t,e)},setInput:function(t,e){return this.yy=e||this.yy||{},this._input=t,this._more=this._backtrack=this.done=!1,this.yylineno=this.yyleng=0,this.yytext=this.matched=this.match="",this.conditionStack=["INITIAL"],this.yylloc={first_line:1,first_column:0,last_line:1,last_column:0},this.options.ranges&&(this.yylloc.range=[0,0]),this.offset=0,this},input:function(){var t=this._input[0];return this.yytext+=t,this.yyleng++,this.offset++,this.match+=t,this.matched+=t,t.match(/(?:\r\n?|\n).*/g)?(this.yylineno++,this.yylloc.last_line++):this.yylloc.last_column++,this.options.ranges&&this.yylloc.range[1]++,this._input=this._input.slice(1),t},unput:function(t){var e=t.length,n=t.split(/(?:\r\n?|\n)/g);this._input=t+this._input,this.yytext=this.yytext.substr(0,this.yytext.length-e),this.offset-=e;var r=this.match.split(/(?:\r\n?|\n)/g);this.match=this.match.substr(0,this.match.length-1),this.matched=this.matched.substr(0,this.matched.length-1),n.length-1&&(this.yylineno-=n.length-1);var i=this.yylloc.range;return this.yylloc={first_line:this.yylloc.first_line,last_line:this.yylineno+1,first_column:this.yylloc.first_column,last_column:n?(n.length===r.length?this.yylloc.first_column:0)+r[r.length-n.length].length-n[0].length:this.yylloc.first_column-e},this.options.ranges&&(this.yylloc.range=[i[0],i[0]+this.yyleng-e]),this.yyleng=this.yytext.length,this},more:function(){return this._more=!0,this},reject:function(){return this.options.backtrack_lexer?(this._backtrack=!0,this):this.parseError("Lexical error on line "+(this.yylineno+1)+". You can only invoke reject() in the lexer when the lexer is of the backtracking persuasion (options.backtrack_lexer = true).\n"+this.showPosition(),{text:"",token:null,line:this.yylineno})},less:function(t){this.unput(this.match.slice(t))},pastInput:function(){var t=this.matched.substr(0,this.matched.length-this.match.length);return(t.length>20?"...":"")+t.substr(-20).replace(/\n/g,"")},upcomingInput:function(){var t=this.match;return t.length<20&&(t+=this._input.substr(0,20-t.length)),(t.substr(0,20)+(t.length>20?"...":"")).replace(/\n/g,"")},showPosition:function(){var t=this.pastInput(),e=new Array(t.length+1).join("-");return t+this.upcomingInput()+"\n"+e+"^"},test_match:function(t,e){var n,r,i;if(this.options.backtrack_lexer&&(i={yylineno:this.yylineno,yylloc:{first_line:this.yylloc.first_line,last_line:this.last_line,first_column:this.yylloc.first_column,last_column:this.yylloc.last_column},yytext:this.yytext,match:this.match,matches:this.matches,matched:this.matched,yyleng:this.yyleng,offset:this.offset,_more:this._more,_input:this._input,yy:this.yy,conditionStack:this.conditionStack.slice(0),done:this.done},this.options.ranges&&(i.yylloc.range=this.yylloc.range.slice(0))),(r=t[0].match(/(?:\r\n?|\n).*/g))&&(this.yylineno+=r.length),this.yylloc={first_line:this.yylloc.last_line,last_line:this.yylineno+1,first_column:this.yylloc.last_column,last_column:r?r[r.length-1].length-r[r.length-1].match(/\r?\n?/)[0].length:this.yylloc.last_column+t[0].length},this.yytext+=t[0],this.match+=t[0],this.matches=t,this.yyleng=this.yytext.length,this.options.ranges&&(this.yylloc.range=[this.offset,this.offset+=this.yyleng]),this._more=!1,this._backtrack=!1,this._input=this._input.slice(t[0].length),this.matched+=t[0],n=this.performAction.call(this,this.yy,this,e,this.conditionStack[this.conditionStack.length-1]),this.done&&this._input&&(this.done=!1),n)return n;if(this._backtrack){for(var a in i)this[a]=i[a];return!1}return!1},next:function(){if(this.done)return this.EOF;var t,e,n,r;this._input||(this.done=!0),this._more||(this.yytext="",this.match="");for(var i=this._currentRules(),a=0;a