├── img
├── git0.png
├── git1.png
├── git2.png
├── git3.png
├── type_parameter.png
└── type_constraint.png
├── README.md
├── gitflow.md
├── GO_OS_ARCH.md
└── gogrammar.md
/img/git0.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/yougg/gonote/HEAD/img/git0.png
--------------------------------------------------------------------------------
/img/git1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/yougg/gonote/HEAD/img/git1.png
--------------------------------------------------------------------------------
/img/git2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/yougg/gonote/HEAD/img/git2.png
--------------------------------------------------------------------------------
/img/git3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/yougg/gonote/HEAD/img/git3.png
--------------------------------------------------------------------------------
/img/type_parameter.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/yougg/gonote/HEAD/img/type_parameter.png
--------------------------------------------------------------------------------
/img/type_constraint.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/yougg/gonote/HEAD/img/type_constraint.png
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | #### 学习过程中记录下来的笔记
2 |
3 |
4 | [Go语言语法详解笔记](https://github.com/yougg/gonote/blob/main/gogrammar.md)
5 | 可以帮助新接触的朋友快速熟悉理解Golang,也可以作为查询手册翻阅。
6 |
--------------------------------------------------------------------------------
/gitflow.md:
--------------------------------------------------------------------------------
1 | 
2 |
3 | #### **◆ Fork代码步骤**
4 |
5 | 
6 |
7 | 1. 进入项目代码主线仓库, 点击`Fork`按钮,再点击用户创建新的Fork仓库.
8 |
9 | 2. 复制Fork的仓库路径(如: http://github.com/username/project.git)
10 | 在本地使用git客户端`clone`此分支代码.
11 | 如果当前已经clone了主线仓库的代码,则按如下方式切换到Fork的仓库.
12 | - 打开`Git Bash`进入本地代码仓库目录
13 |
14 | ```bash
15 | cd /home/cxy/go/src/myproject/
16 | ```
17 | - 切换本地仓库对应的远程路径为Fork仓库的路径
18 |
19 | ```bash
20 | git remote set-url origin http://github.com/username/project.git
21 | ```
22 | - 查看本地仓库对应的路径是否更新
23 |
24 | ```bash
25 | git remote -v
26 | ```
27 |
28 | 3. 切换本地仓库代码分支
29 | - 首先更新代码(确保本地所有代码已提交,没有未合并的分支)
30 |
31 | ```bash
32 | git fetch
33 | ```
34 | - 切换分支
35 |
36 | ```bash
37 | git checkout -b develop origin/develop
38 | ```
39 |
40 | 
41 |
42 | #### **◆ 从主线仓库更新代码到本地Fork仓库的分支步骤**
43 |
44 | 1. 增加主线代码仓库地址
45 | 打开`Git Bash`进入本地代码仓库目录执行
46 | ```bash
47 | git remote add trunk http://github.com/mygroup/project.git
48 | ```
49 |
50 | 2. 查看本地仓库对应的路径是否更新
51 | ```bash
52 | git remote -v
53 | ```
54 | 有类似如下输出:
55 | >origin http://github.com/username/project.git (fetch)
56 | origin http://github.com/username/project.git (push)
57 | trunk http://github.com/mygroup/project.git (fetch)
58 | trunk http://github.com/mygroup/project.git (push)
59 |
60 | 2. 从主线仓库origin/develop分支
61 | 更新代码到本地Fork仓库的origin/develop分支
62 | - 在`IDEA`中更新
63 | 1. 选中项目,点击右键`Git`菜单,选择`Repository` -> `Pull...`
64 | 2. 选择`Remote`为新增的主线远程仓库路径
65 | 3. 选择分支为`origin/develop`,然后点击`Pull`拉取代码进行更新.
66 | 4. 如果代码存在冲突,在提示合并窗口中进行合并操作.
67 | - 在命令行更新
68 |
69 | ```bash
70 | git pull http://github.com/mygroup/project.git trunk develop
71 | ```
72 |
73 | 
74 |
75 | #### **◆ 合并代码到主线仓库步骤**
76 |
77 | 1. 本地修改提交代码, 使用IDEA界面`Ctrl + k`提交或者命令`git commit`
78 |
79 | 2. 推送本地代码到Fork仓库,使用IDEA界面`Ctrl + Shift+ k`推送或者命令`git push`
80 |
81 | 3. 在git服务器上`Fork`的工程中新建`Merge Request`合并请求
82 | `Source branch`选择用户Fork仓库下的`develop`分支
83 | `Target branch`选择主线仓库下的`develop`分支
84 | 点击`Compare branches`进行对比,完善信息后提交合并请求
85 |
86 | 4. `Committer`接受合并请求,合入代码.
87 |
88 | #### **◆ 主线代码仓库发布版本步骤**
89 |
90 | 1. `Committer`在git服务器上主线代码仓库新建`Merge Request`合并请求
91 | `Source branch`选择主线仓库下的`develop`分支
92 | `Target branch`选择主线仓库下的`master`分支
93 | 点击`Compare branches`进行对比,完善信息后提交合并请求
94 |
95 | 2. 在CI服务器更新最新版本代码
96 | - 编译daily版本
97 |
98 | > 切换代码分支到`develop`
99 | - 编译release版本
100 |
101 | > 切换代码分支到`master`
102 |
--------------------------------------------------------------------------------
/GO_OS_ARCH.md:
--------------------------------------------------------------------------------
1 | # Golang supported OS/Arch table `go1.25`
2 |
3 | ## GOOS GOARCH
4 |
5 | | Architecture | GOOS →
GOARCH↓ | `aix` | `android` | `darwin` | `dragonfly` | `freebsd` | `illumos` | `ios` | `js` | `linux` | `netbsd` | `openbsd` | `plan9` | `solaris` | `wasip1` | `windows` |
6 | |:---------------------------------|:-----------------:|:--------:|:---------:|:--------:|:-----------:|:---------:|:---------:|:--------:|:--------:|:--------:|:--------:|:---------:|:--------:|:---------:|:--------:|:---------:|
7 | | x86 32-bit | `386` | | ✔ | | | ✔ | | | | ✔ | ✔ | ✔ | ✔ | | | ✔ |
8 | | x86 64-bit | `amd64` | | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | | ✔ | ✔ | ✔ | ✔ | ✔ | | ✔ |
9 | | ARM 32-bit | `arm` | | ✔ | ✔ | | ✔ | | ✔ | | ✔ | ✔ | ✔ | ✔ | | | ✔ |
10 | | ARM 64-bit | `arm64` | | ✔ | ✔ | | ✔ | | ✔ | | ✔ | ✔ | ✔ | | | | ✔ |
11 | | LoongArch 64-bit | `loong64` | | | | | | | | | ✔ | | | | | | |
12 | | MIPS 32-bit,
big-endian | `mips` | | | | | | | | | ✔ | | | | | | |
13 | | MIPS 64-bit,
big-endian | `mips64` | | | | | | | | | ✔ | | | | | | |
14 | | MIPS 64-bit,
little-endian | `mips64le` | | | | | | | | | ✔ | | | | | | |
15 | | MIPS 32-bit,
little-endian | `mipsle` | | | | | | | | | ✔ | | | | | | |
16 | | PowerPC 64-bit,
big-endian | `ppc64` | ✔ | | | | | | | | ✔ | | ✔ | | | | |
17 | | PowerPC 64-bit,
little-endian | `ppc64le` | | | | | | | | | ✔ | | | | | | |
18 | | RISC-V 64-bit | `riscv64` | | | | | ✔ | | | | ✔ | | ✔ | | | | |
19 | | IBM ESA/390 | `s390x` | | | | | | | | | ✔ | | | | | | |
20 | | WebAssembly | `wasm` | | | | | | | | ✔ | | | | | | ✔ | |
21 |
22 | ## script for print Markdown table
23 |
24 | ```bash
25 | #!/bin/bash
26 |
27 | DIST=$(go tool dist list)
28 | OSes=$(go tool dist list | awk -F '/' '{print $1}' | sort -u)
29 | ARCHes=$(go tool dist list | awk -F '/' '{print $2}' | sort -u)
30 |
31 | # print table header
32 | echo -n '| GOOS →
GOARCH↓ |'
33 | echo '`'$OSes'`|' | sed 's/\ /`|`/g'
34 |
35 | # print separator
36 | echo -n '|:--------:|'
37 | for o in $OSes; do
38 | echo -n ':------:|'
39 | done
40 | echo
41 |
42 | # print table body
43 | for a in $ARCHes; do
44 | printf '|%-10s' '`'$a'`'
45 | for o in $OSes; do
46 | if `echo $DIST | grep "$o/$a" &> /dev/null`; then
47 | echo -n '|✔'
48 | else
49 | echo -n '| '
50 | fi
51 | done
52 | echo '|'
53 | done
54 | ```
55 |
--------------------------------------------------------------------------------
/gogrammar.md:
--------------------------------------------------------------------------------
1 | ## Google Go语言 golang 语法详解笔记
2 |
3 | | *Title* | Go Grammar Note |
4 | |-----------:|:----------------------------------------------------------------------------|
5 | | *Author* | yougg |
6 | | *Date* | 2025-12-17 |
7 | | *Version* | 1.25.5 |
8 | | *Source* | [Fork me on GitHub](https://github.com/yougg/gonote) |
9 | | *Describe* | 学习Go语言过程中记录下来的语法详解笔记,可以帮助新接触的朋友快速熟悉理解Golang,也可以作为查询手册翻阅,若有错误请在GitHub提issue。 |
10 |
11 | ---
12 |
13 | - [包 Package](#包-package)
14 |
15 | - [包的声明 Declare](#包的声明-declare)
16 | - [包的导入 Import](#包的导入-import)
17 | - [包内元素的可见性 Accessibility](#包内元素的可见性-accessibility)
18 |
19 | - [数据类型 Data Type](#数据类型-data-type)
20 |
21 | - [基础数据类型 Basic data type](#基础数据类型-basic-data-type)
22 | - [变量 Variable](#变量-variable)
23 | - [常量 Constant](#常量-constant)
24 | - [数组 Array](#数组-array)
25 | - [切片 Slice](#切片-slice)
26 | - [字典/映射 Map](#字典映射-map)
27 | - [结构体 Struct](#结构体-struct)
28 | - [指针 Pointer](#指针-pointer)
29 | - [通道 Channel](#通道-channel)
30 | - [接口 Interface](#接口-interface)
31 | - [自定义类型](#自定义类型)
32 |
33 | - [语句 Statement](#语句-statement)
34 |
35 | - [分号/括号 ; {](#分号括号--)
36 | - [条件语句 if](#条件语句-if)
37 | - [分支选择 switch](#分支选择-switch)
38 | - [循环语句 for](#循环语句-for)
39 | - [通道选择 select](#通道选择-select)
40 | - [延迟执行 defer](#延迟执行-defer)
41 | - [跳转语句 goto](#跳转语句-goto)
42 | - [阻塞语句 blocking](#阻塞语句-blocking)
43 |
44 | - [函数 Function](#函数-function)
45 |
46 | - [函数声明 Declare](#函数声明-declare)
47 | - [函数闭包 Closure](#函数闭包-closure)
48 | - [内建函数 Builtin](#内建函数-builtin)
49 | - [初始化函数 init](#初始化函数-init)
50 | - [方法 Method](#方法-method)
51 |
52 | - [并发 Concurrency](#并发-concurrency)
53 |
54 | - [测试 Testing](#测试-testing)
55 |
56 | - [单元测试 Unit](#单元测试-unit)
57 | - [基准测试 Benchmark](#基准测试-benchmark)
58 | - [模糊测试 Fuzzing](#模糊测试-fuzzing)
59 |
60 | - [泛型 Generics](#泛型-generics)
61 |
62 | - [类型约束](#类型约束-constraint)
63 | - [类型参数](#类型参数-parameters)
64 |
65 | ---
66 |
67 | ## **包 Package**
68 |
69 | ### **包的声明, keyword:`package`**
70 |
71 | - 使用`package`关键字声明当前源文件所在的包
72 | 包声明语句是所有源文件的第一行非注释语句
73 | 包名称中不能包含空白字符
74 | 包名推荐与源文件所在的目录名称保持一致
75 | 每个目录中只能定义一个package名称 (例外: 用于黑盒测试的`_test.go`文件包名为`当前包名_test`)
76 |
77 | ```go
78 | package abc // 声明一个名为“abc”的包
79 | ```
80 | ```go
81 | package 我的包 // 声明一个名为“我的包”的包
82 | ```
83 | ```go
84 | package main // main包, 程序启动执行的入口包
85 | ```
86 |
87 | 错误的包声明
88 | ```go
89 | package "mypkg" // ❌错误
90 | ```
91 | ```go
92 | package a/b/c // ❌错误
93 | ```
94 | ```go
95 | package a.b.c // ❌错误
96 | ```
97 |
98 | ### **包的导入, keyword:`import`**
99 |
100 | - 导入包路径是对应包在如下列表中的相对路径
101 |
102 | - `$GOROOT/src/`
103 | - `$GOPATH/src/`
104 | - `$GOPATH/pkg/mod/`
105 | - `当前路径`
106 | - `go.mod`模块名声明中的相对路径
107 |
108 | 导入`$GOROOT/src/`中的相对路径包(官方标准库)
109 |
110 | ```go
111 | import "fmt"
112 | import "math/rand"
113 | ```
114 |
115 | 导入`$GOPATH/src/`或`$GOPATH/pkg/mod/`中的相对路径包
116 |
117 | ```go
118 | import "github.com/user/project/pkg"
119 | import "code.google.com/p/project/pkg"
120 | ```
121 |
122 | 导入当前包的相对路径包 `Deprecated`
123 | 例如有Go目录如下:
124 | `MODULE`
125 | ├─x0
126 | │ ├─y0
127 | │ │ └─z0
128 | │ └─y1
129 | │ └─z1
130 | └─x1
131 | └─y2
132 |
133 | ```go
134 | import "./y0/z0" // 在x0包中导入子包 z0包
135 | import "../y0/z0" // 在y1包中导入子包 z0包
136 | import "x0/y1/z1" // 在y2包中导入 z1包
137 | ```
138 |
139 | 错误的导入包路径
140 |
141 | ```go
142 | import a/b/c // ❌错误
143 | import "a.b.c" // ❌错误
144 | import a.b.c // ❌错误
145 | ```
146 |
147 | - 用圆括号组合导入包路径
148 |
149 | ```go
150 | import ("fmt"; "math")
151 |
152 | import (
153 | "fmt"
154 | "math"
155 | )
156 | ```
157 |
158 | - 导入包可以定义别名,防止同名称的包冲突
159 |
160 | ```go
161 | import (
162 | "a/b/c"
163 |
164 | c1 "x/y/c" // 将导入的包c定义别名为 c1
165 |
166 | 格式化 "fmt" // 将导入的包fmt定义别名为 格式化
167 |
168 | m "math" // 将导入的包math定义别名为 m
169 | )
170 | ```
171 |
172 | - 引用包名是导入包路径的最后一个目录中定义的唯一包的名称
173 | 定义的包名与目录同名时,直接引用即可
174 |
175 | ```go
176 | // 引用普通名称的导入包
177 | c.hello()
178 |
179 | // 引用定义别名的包
180 | 格式化.Println(m.Pi)
181 | ```
182 |
183 | 定义的包名与所在目录名称不同时,导入包路径仍为目录所在路径,引用包名为定义的包名称
184 |
185 | ```go
186 | // Package util
187 | // 源文件路径: proj/my-util/util.go
188 | package util
189 | ```
190 | ```go
191 | // 导入util包路径
192 | import "proj/my-util"
193 |
194 | // 引用util包
195 | util.doSomething()
196 | ```
197 |
198 | - 静态导入,在导入的包路径之前增加一个小数点`.`
199 |
200 | ```go
201 | // 类似C中的include 或Java中的import static
202 | import . "fmt"
203 |
204 | // 然后像使用本包元素一样使用fmt包中可见的元素,不需要通过包名引用
205 | Println("no need package name")
206 | ```
207 |
208 | - 导入包但不直接使用该包,在导入的包路径之前增加一个下划线`_`
209 |
210 | ```go
211 | // 如果当前go源文件中未引用过log包,将会导致编译错误
212 | import "log" // ❌错误
213 | import . "log" // ❌静态导入未使用同样报错
214 |
215 | // 在包名前面增加下划线表示导入包但是不直接使用它,被导入的包中的init函数会在导入的时候执行
216 | import _ "github.com/go-sql-driver/mysql"
217 | ```
218 |
219 | ### **包内元素的可见性 Accessibility**
220 |
221 | - 名称首字符为[Unicode包含的大写字母](http://www.fileformat.info/info/unicode/category/Lu/list.htm)的元素是被导出的,对外部包是可见的
222 | 首字为非大写字母的元素只对本包可见(同包跨源文件可以访问,子包不能访问)
223 |
224 | ```go
225 | var In int // In is exported
226 | var in byte // in is unexported
227 | var ȸȹ string // ȸȹ is unexported
228 | const Ȼom bool = false // Ȼom is exported
229 | const ѧѩ uint8 = 1 // ѧѩ is unexported
230 | type Ĩnteger int // Ĩnteger is exported
231 | type ブーリアン *bool // ブーリアン is unexported
232 | func Ӭxport() {...} // Ӭxport is exported
233 | func įnner() {...} // įnner is unexported
234 | func (me *Integer) ⱱalueOf(s string) int {...} // ⱱalueOf is unexported
235 | func (i ブーリアン) Ȿtring() string {...} // Ȿtring is exported
236 | ```
237 |
238 | - internal包(内部包) `Go1.4+`
239 | internal包及其子包中的导出元素只能被与internal同父包的其他包访问
240 |
241 | 例如有Go目录如下:
242 | `MODULE`
243 | ├─x0
244 | │ ├─`internal`
245 | │ │ └─z0
246 | │ └─y0
247 | │ └─z1
248 | └─x1
249 | └─y1
250 |
251 | 在x0,y0,z1包中可以访问internal,z0包中的可见元素
252 | 在x1,y1包中不能导入internal,z0包
253 |
254 | - 规范导入包路径Canonical import paths `Go1.4+`
255 | 包声明语句后面添加标记注释,用于标识这个包的规范导入路径。
256 |
257 | ```go
258 | package pdf // import "rsc.io/pdf"
259 | ```
260 |
261 | 如果使用此包的代码的导入的路径不是规范路径,go命令会拒绝编译。
262 | 例如有 [rsc.io/pdf]() 的一个fork路径 [github.com/rsc/pdf]()
263 | 如下程序代码导入路径时使用了非规范的路径则会被go拒绝编译
264 |
265 | ```go
266 | import "github.com/rsc/pdf"
267 | ```
268 |
269 | ## **数据类型 Data Type**
270 |
271 | ### **基础数据类型 Basic data type**
272 |
273 | - 基本类型包含:数值类型,布尔类型,字符串
274 |
275 | | 类型 | 占用空间(byte) | 取值范围 | 默认零值 | 类型 | 占用空间(byte) | 取值范围 | 默认零值 |
276 | |:---------------|:----------:|:--------------------------------------:|:------:|:--------------:|:----------:|:------------------------:|:-------:|
277 | | `int` | 4,8 | **int32,int64** | 0 | `uint` | 4,8 | **uint32,uint64** | 0 |
278 | | `int8` | 1 | **-27 ~ 27-1** | 0 | `uint8`,`byte` | 1 | 0 ~ **28-1** | 0 |
279 | | `int16` | 2 | **-215 ~ 215-1** | 0 | `uint16` | 2 | 0 ~ **216-1** | 0 |
280 | | `int32`,`rune` | 4 | **-231 ~ 231-1** | 0 | `uint32` | 4 | 0 ~ **232-1** | 0 |
281 | | `int64` | 8 | **-263 ~ 263-1** | 0 | `uint64` | 8 | 0 ~ **264-1** | 0 |
282 | | `float32` | 4 | IEEE-754 32-bit | 0.0 | `float64` | 4 | IEEE-754 64-bit | 0.0 |
283 | | `complex64` | 8 | **float32+float32**i | 0 + 0i | `complex128` | 16 | **float64+float64**i | 0 + 0i |
284 | | `bool` | 1 | **true,false** | false | `string` | - | "" ~ "∞" | "",\`\` |
285 | | `uintptr` | 4,8 | **uint32,uint64** | 0 | `error` | - | - | nil |
286 |
287 | > `byte` 是 `uint8` 的别名
288 | `rune` 是 `int32` 的别名,代表一个Unicode码点
289 | `int`与`int32`或`int64`是不同的类型,只是根据架构对应32/64位值
290 | `uint`与`uint32`或`uint64`是不同的类型,只是根据架构对应32/64位值
291 |
292 | ### **变量 Variable, keyword:`var`**
293 |
294 | - 变量声明, 使用`var`关键字
295 | Go中只能使用`var` **声明**变量,无需显式初始化值
296 |
297 | ```go
298 | var i int // i = 0
299 |
300 | var s string // s = "" (Go中的string是值类型,默认零值是空串 "" 或 ``,不存在nil(null)值)
301 |
302 | var e error // e = nil, error是Go的内建接口类型。
303 | ```
304 |
305 | 关键字的顺序错误或缺少都是编译错误的
306 |
307 | ```go
308 | var int a // ❌编译错误
309 | a int // ❌编译错误
310 | int a // ❌编译错误
311 | ```
312 |
313 | - `var` 语句可以声明一个变量列表,类型在变量名之后
314 |
315 | ```go
316 | var a,b,c int // a = 0, b = 0, c = 0
317 | var (
318 | a int // a = 0
319 | b string // b = ""
320 | c uint // c = 0
321 | )
322 | var (
323 | a,b,c int
324 | d string
325 | )
326 | ```
327 |
328 | - 变量定义时初始化赋值,每个变量对应一个值
329 |
330 | ```go
331 | var a int = 0
332 | var a, b int = 0, 1
333 | ```
334 |
335 | - 变量定义并初始化时可以省略类型,Go自动根据初始值推导变量的类型
336 |
337 | ```go
338 | var a = 'A' // a int32
339 | var a,b = 0, "B" // a int, b string
340 | ```
341 |
342 | - 使用组合符号`:=`定义并初始化变量,根据符号右边表达式的值的类型声明变量并初始化它的值
343 | `:=` 不能在函数外使用,函数外的每个语法块都必须以关键字开始
344 |
345 | ```go
346 | a := 3 // a int
347 | a, b, c := 8, '呴', true // a int, b int32, c bool
348 | c := `formatted
349 | string` // c string
350 | c := 1 + 2i // c complex128
351 | ```
352 |
353 | ### **常量 Constant, keyword:`const`**
354 |
355 | - 常量可以是字符、字符串、布尔或数值类型的值,数值常量是高精度的值
356 |
357 | ```go
358 | const x int = 3
359 | const y,z int = 1,2
360 | const (
361 | a byte = 'A'
362 | b string = "B"
363 | c bool = true
364 | d int = 4
365 | e float32 = 5.1
366 | f complex64 = 6 + 6i
367 | )
368 | ```
369 |
370 | - 根据常量值自动推导类型
371 |
372 | ```go
373 | const a = 0 // a int
374 | const (
375 | b = 2.3 // b float64
376 | c = true // c bool
377 | )
378 | ```
379 |
380 | - 常量组内定义时复用表达式
381 | 常量组内定义的常量只有名称时,其值会根据上一次最后出现的常量表达式计算相同的类型与值
382 |
383 | ```go
384 | const (
385 | a = 3 // a = 3
386 | b // b = 3
387 | c // c = 3
388 | d = len("asdf") // d = 4
389 | e // e = 4
390 | f // f = 4
391 | g,h,i = 7,8,9 // 复用表达式要一一对应
392 | x,y,z // x = 7, y = 8, z = 9
393 | )
394 | ```
395 |
396 | - 自动递增枚举常量 `iota`
397 | iota的枚举值可以赋值给数值兼容类型
398 | 每个常量单独声明时,`iota`不会自动递增
399 |
400 | ```go
401 | const a int = iota // a = 0
402 | const b int = iota // b = 0
403 | const c byte = iota // c = 0
404 | const d uint64 = iota // d = 0
405 | ```
406 |
407 | - 常量组合声明时,`iota`每次引用会逐步自增,初始值为0,步进值为1
408 |
409 | ```go
410 | const (
411 | a uint8 = iota // a = 0
412 | b int16 = iota // b = 1
413 | c rune = iota // c = 2
414 | d float64 = iota // d = 3
415 | e uintptr = iota // e = 4
416 | )
417 | ```
418 |
419 | - 即使`iota`不是在常量组内第一个开始引用,也会按组内常量数量递增
420 |
421 | ```go
422 | const (
423 | a = "A"
424 | b = 'B'
425 | c = iota // c = 2
426 | d = "D"
427 | e = iota // e = 4
428 | )
429 | ```
430 |
431 | - 枚举的常量都为同一类型时,可以使用简单序列格式(组内复用表达式).
432 |
433 | ```go
434 | const (
435 | a = iota // a int32 = 0
436 | b // b int32 = 1
437 | c // c int32 = 2
438 | )
439 | ```
440 |
441 | - 枚举序列中的未指定类型的常量会跟随序列前面最后一次出现类型定义的类型
442 |
443 | ```go
444 | const (
445 | a byte = iota // a uint8 = 0
446 | b // b uint8 = 1
447 | c // c uint8 = 2
448 | d rune = iota // d int32 = 3
449 | e // e int32 = 4
450 | f // f int32 = 5
451 | )
452 | ```
453 |
454 | - `iota`自增值只在一个常量定义组合中有效,跳出常量组合定义后`iota`初始值归0
455 |
456 | ```go
457 | const (
458 | a = iota // a int32 = 0
459 | b // b int32 = 1
460 | c // c int32 = 2
461 | )
462 | const (
463 | e = iota // e int32 = 0 (iota重新初始化并自增)
464 | f // f int32 = 1
465 | )
466 | ```
467 |
468 | - 定制`iota`序列初始值与步进值 (通过组合内复用表达式实现)
469 |
470 | ```go
471 | const (
472 | a = (iota + 2) * 3 // a int32 = 6 (a=(0+2)*3) 初始值为6,步进值为3
473 | b // b int32 = 9 (b=(1+2)*3)
474 | c // c int32 = 12 (c=(2+2)*3)
475 | d // d int32 = 15 (d=(3+2)*3)
476 | )
477 | ```
478 |
479 | ### **数组 Array**
480 |
481 | - 数组声明带有长度信息且长度固定,数组是值类型默认零值不是`nil`,传递参数时会进行复制。
482 | 声明定义数组时中括号`[ ]`在类型名称之前,赋值引用元素时中括号`[ ]`在数组变量名之后。
483 |
484 | ```go
485 | var a [3]int = [3]int{0, 1, 2} // a = [0 1 2]
486 | var b [3]int = [3]int{} // b = [0 0 0]
487 | var c [3]int
488 | c = [3]int{}
489 | c = [3]int{0,0,0} // c = [0 0 0]
490 | d := [3]int{} // d = [0 0 0]
491 | fmt.Printf("%T\t%#v\t%d\t%d\n", d, d, len(d), cap(d)) // [3]int [3]int{0, 0, 0} 3 3
492 | ```
493 |
494 | 使用`...`自动计算数组的长度
495 |
496 | ```go
497 | var a = [...]int{0, 1, 2}
498 |
499 | // 多维数组只能自动计算最外围数组长度
500 | x := [...][3]int{{0, 1, 2}, {3, 4, 5}}
501 | y := [...][2][2]int{{{0,1},{2,3}},{{4,5},{6,7}}}
502 |
503 | // 通过下标访问数组元素
504 | println(y[1][1][0]) // 6
505 | ```
506 |
507 | 初始化指定索引的数组元素,未指定初始化的元素保持默认零值
508 |
509 | ```go
510 | var a = [3]int{2:3}
511 | var b = [...]string{2:"c", 3:"d"}
512 | ```
513 |
514 | ### **切片 Slice**
515 |
516 | - slice 切片是对一个数组上的连续一段的引用,并且同时包含了长度和容量信息
517 | 因为是引用类型,所以未初始化时的默认零值是`nil`,长度与容量都是0
518 |
519 | ```go
520 | var a []int
521 | fmt.Printf("%T\t%#v\t%d\t%d\n", a, a, len(a), cap(a)) // []int []int(nil) 0 0
522 |
523 | // 可用类似数组的方式初始化slice
524 | var d []int = []int{0, 1, 2}
525 | fmt.Printf("%T\t%#v\t%d\t%d\n", d, d, len(d), cap(d)) // []int []int{0, 1, 2} 3 3
526 |
527 | var e = []string{2:"c", 3:"d"}
528 | ```
529 |
530 | 使用内置函数make初始化slice,第一参数是slice类型,第二参数是长度,第三参数是容量(省略时与长度相同)
531 |
532 | ```go
533 | var b = make([]int, 0)
534 | fmt.Printf("%T\t%#v\t%d\t%d\n", b, b, len(b), cap(b)) // []int []int{} 0 0
535 |
536 | var c = make([]int, 3, 10)
537 | fmt.Printf("%T\t%#v\t%d\t%d\n", c, c, len(c), cap(c)) // []int []int{} 3 10
538 |
539 | var a = new([]int)
540 | fmt.Printf("%T\t%#v\t%d\t%d\n", a, a, len(*a), cap(*a)) // *[]int &[]int(nil) 0 0
541 | ```
542 |
543 | - 基于slice或数组重新切片,创建一个新的 slice 值指向相同的数组
544 | 重新切片支持两种格式:
545 |
546 | 2个参数 `slice[beginIndex:endIndex]`
547 | 需要满足条件:0 <= beginIndex <= endIndex <= cap(slice)
548 | 截取从开始索引到结束索引-1 之间的片段
549 | 新slice的长度:`length=(endIndex - beginIndex)`
550 | 新slice的容量:`capacity=(cap(slice) - beginIndex)`
551 | beginIndex的值可省略,默认为0
552 | endIndex 的值可省略,默认为len(slice)
553 |
554 | ```go
555 | s := []int{0, 1, 2, 3, 4}
556 | a := s[1:3] // a: [1 2], len: 2, cap: 4
557 | b := s[:4] // b: [0 1 2 3], len: 4, cap: 5
558 | c := s[1:] // c: [1 2 3 4], len: 4, cap: 4
559 | d := s[1:1] // d: [], len: 0, cap: 4
560 | e := s[:] // e: [0 1 2 3 4], len: 5, cap: 5
561 | ```
562 |
563 | 3个参数 `slice[beginIndex:endIndex:capIndex]` `Go1.2+`
564 | 需要满足条件:0 <= beginIndex <= endIndex <= capIndex <= cap(slice)
565 | 新slice的长度:`length=(endIndex - beginIndex)`
566 | 新slice的容量:`capacity=(capIndex - beginIndex)`
567 | beginIndex的值可省略,默认为0
568 |
569 | ```go
570 | s := make([]int, 5, 10)
571 | a := s[9:10:10] // a: [0], len: 1, cap: 1
572 | b := s[:3:5] // b: [0 0 0], len: 3, cap: 5
573 | ```
574 |
575 | - 切片类型转换为数组类型
576 | 数组是值类型通过切片强制转换类型得到的是从原切片指向底层数组的副本
577 | 转换的数组类型可以指定长度为小于/等于原切片的长度值 (不是切片的容量值)
578 |
579 | Go1.19及之前的版本需要先转换为数组指针后再从指针取值
580 |
581 | ```go
582 | slice := []int{1,2,3,4,5}
583 | array := *(*[3]int)(slice)
584 | ```
585 |
586 | 直观的方式直接强制转换类型 `Go1.20+`
587 |
588 | ```go
589 | slice := []int{1,2,3}
590 | array := [3]int(slice)
591 | ```
592 |
593 | ```go
594 | slice := make([]int, 0, 10)
595 | array0 := [0]int(slice) // 此时切片的长度是0
596 | array1 := [3]int(slice) // panic: 不能将切片0长度的底层数组转换为指定长度的数组
597 | slice = append(slice, 1,2,3,4,5) // 此时切片的长度是5
598 | arrPtr := (*[5]int)(slice) // 获取切片底层数组的指针
599 | array := [3]int(slice) // 强制转换类型从切片底层数组复制前3个元素构造了新的数组值
600 |
601 | arrPtr[1] = 20 // 切片底层数组的指针修改数组的值会影响原切片
602 | array[2] = 30 // 新数组的值不再影响原切片
603 | fmt.Println(slice) // [1 20 3 4 5]
604 | fmt.Println(array) // [1 2 30]
605 | ```
606 |
607 | - 向slice中追加/修改元素
608 |
609 | ```go
610 | var s []string
611 | s = append(s, "a") // 添加一个元素
612 | s = append(s, "b", "c", "d") // 添加一列元素
613 | t = []string{"e", "f", "g"}
614 | s = append(s, t...} // 添加另一个切片t的所有元素
615 | s = append(s, t[:2]...} // 添加另一个切片t的部分元素
616 |
617 | s[0] = "A" // 修改切片s的第一个元素
618 | s[len(s)-1] = "G" // 修改切片s的最后一个元素
619 | ```
620 |
621 | - 向slice指定位置插入元素,从slice中删除指定的元素
622 | 因为slice引用指向底层数组,数组的长度不变元素是不能插入/删除的
623 | 插入的原理就是从插入的位置将切片分为两部分依次将首部、新元素、尾部拼接为一个新的切片
624 | 删除的原理就是排除待删除元素后用其他元素重新构造一个数组
625 |
626 | ```go
627 | func insertSlice(s []int, i int, elements ...int) []int {
628 | // x := append(s[:i], append(elements, s[i:]...)...)
629 | x := s[:i]
630 | x = append(x, elements...)
631 | x = append(x, s[i:]...)
632 | return x
633 | }
634 |
635 | func deleteByAppend() {
636 | i := 3
637 | s := []int{1, 2, 3, 4, 5, 6, 7}
638 | // delete the fourth element(index is 3), using append
639 | s = append(s[:i], s[i+1:]...)
640 | }
641 |
642 | func deleteByCopy() {
643 | i := 3
644 | s := []int{1, 2, 3, 4, 5, 6, 7}
645 | if i < len(s) / 2 {
646 | copy(s[1:], s[:i]) // 将[0:i)位置元素复制到[1:i]
647 | s = s[1:] // 排除第0个元素
648 | } else {
649 | copy(s[i:], s[i+1:]) // 将[i+1:len(s))位置元素复制到[i:len(s))
650 | s = s[:len(s)-1] // 排除末尾元素
651 | }
652 | }
653 | ```
654 |
655 | ### **字典/映射 Map, keyword:`map`**
656 |
657 | - map是引用类型,使用内置函数 `make`进行初始化,未初始化的map零值为 `nil`长度为0,并且不能赋值元素
658 |
659 | ```go
660 | var m map[int]int
661 | m[0] = 0 // × runtime error: assignment to entry in nil map
662 | fmt.Printf("type: %T\n", m) // map[int]int
663 | fmt.Printf("value: %#v\n", m) // map[int]int(nil)
664 | fmt.Printf("value: %v\n", m) // map[]
665 | fmt.Println("is nil: ", nil == m) // true
666 | fmt.Println("length: ", len(m)) // 0,if m is nil, len(m) is zero.
667 | ```
668 |
669 | 使用内置函数make初始化map
670 |
671 | ```go
672 | var m map[int]int = make(map[int]int)
673 | m[0] = 0 // 插入或修改元素
674 | fmt.Printf("type: %T\n", m) // map[int]int
675 | fmt.Printf("value: %#v\n", m) // map[int]int(0:0)
676 | fmt.Printf("value: %v\n", m) // map[0:0]
677 | fmt.Println("is nil: ", nil == m) // false
678 | fmt.Println("length: ", len(m)) // 1
679 | ```
680 |
681 | 直接赋值初始化map
682 |
683 | ```go
684 | m := map[int]int{
685 | 0:0,
686 | 1:1, // 最后的逗号是必须的
687 | }
688 | n := map[string]S{
689 | "a":S{0,1},
690 | "b":{2,3}, // 类型名称可省略
691 | }
692 | ```
693 |
694 | map的使用:读取、添加、修改、删除元素
695 |
696 | ```go
697 | m[0] = 3 // 修改m中key为0的值为3
698 | m[4] = 8 // 添加到m中key为4值为8
699 |
700 | a := n["a"] // 获取n中key为“a“的值
701 | b, ok := n["c"] // 取值, 并通过ok(bool)判断key对应的元素是否存在.
702 |
703 | delete(n, "a") // 使用内置函数delete删除key为”a“对应的元素.
704 | ```
705 |
706 | ### **结构体 Struct, keyword:`type` `struct`**
707 |
708 | - 结构体类型`struct`是一个字段的集合
709 |
710 | ```go
711 | type S struct {
712 | A int
713 | B, c string
714 | }
715 | ```
716 |
717 | - 结构体初始化通过结构体字段的值作为列表来新分配一个结构体。
718 |
719 | ```go
720 | var s S = S{0, "1", "2"}
721 | ```
722 |
723 | - 使用 Name: 语法可以仅列出部分字段(字段名的顺序无关)
724 |
725 | ```go
726 | var s S = S{B: "1", A: 0}
727 | ```
728 |
729 | - 结构体是值类型,传递时会复制值,其默认零值不是`nil`
730 |
731 | ```go
732 | var a S
733 | var b = S{}
734 | fmt.Println(a == b) // true
735 | ```
736 |
737 | - 结构体组合
738 | 将一个`命名类型`作为匿名字段嵌入一个结构体
739 | 嵌入匿名字段支持命名类型、命名类型的指针和接口类型
740 |
741 | ```go
742 | package main
743 |
744 | type (
745 | A struct {
746 | v int
747 | }
748 |
749 | // B 定义结构体B,嵌入结构体A作为匿名字段
750 | B struct {
751 | A
752 | }
753 |
754 | // C 定义结构体C,嵌入结构体A的指针作为匿名字段
755 | C struct {
756 | *A
757 | }
758 | )
759 |
760 | func (a *A) setV(v int) {
761 | a.v = v
762 | }
763 |
764 | func (a A) getV() int {
765 | return a.v
766 | }
767 |
768 | func (b B) getV() string {
769 | return "B"
770 | }
771 |
772 | func (c *C) getV() bool {
773 | return true
774 | }
775 |
776 | func main() {
777 | a := A{}
778 | b := B{} // 初始化结构体B,其内匿名字段A默认零值是A{}
779 | c := C{&A{}} // 初始化结构体C,其内匿名指针字段*A默认零值是nil,需要初始化赋值
780 |
781 | println(a.v)
782 |
783 | // 结构体A嵌入B,A内字段自动提升到B
784 | println(b.v)
785 |
786 | // 结构体指针*A嵌入C,*A对应结构体内字段自动提升到C
787 | println(c.v)
788 |
789 | a.setV(3)
790 | b.setV(5)
791 | c.setV(7)
792 | println(a.getV(), b.A.getV(), c.A.getV())
793 | println(a.getV(), b.getV(), c.getV())
794 | }
795 | ```
796 |
797 | - 匿名结构体
798 | 匿名结构体声明时省略了`type`关键字,并且没有名称
799 |
800 | ```go
801 | package main
802 |
803 | import "fmt"
804 |
805 | type Integer int
806 |
807 | // 声明变量a为空的匿名结构体类型
808 | var a struct{}
809 |
810 | // 声明变量b为包含一个字段的匿名结构体类型
811 | var b struct{ x int }
812 |
813 | // 声明变量c为包含两个字段的匿名结构体类型
814 | var c struct {
815 | u int
816 | v bool
817 | }
818 |
819 | func main() {
820 | printa(a)
821 | b.x = 1
822 | fmt.Printf("bx: %#v\n", printb(b)) // bx: struct { y uint8 }{y:0x19}
823 | printc(c)
824 |
825 | // 声明d为包含3个字段的匿名结构体并初始化部分字段
826 | d := struct {
827 | x int
828 | y complex64
829 | z string
830 | }{
831 | z: "asdf",
832 | x: 111,
833 | }
834 | d.y = 22 + 333i
835 | fmt.Printf("d: %#v\n", d) // d: struct { x int; y complex64; z string }{x:111, y:(22+333i), z:"asdf"}
836 |
837 | // 声明变量e为包含两个字段的匿名结构体类型
838 | // 包含1个匿名结构体类型的命名字段和1个命名类型的匿名字段
839 | e := struct {
840 | a struct{ x int }
841 | // 结构体组合嵌入匿名字段只支持命名类型
842 | Integer
843 | }{}
844 | e.Integer = 444
845 | fmt.Printf("e: %#v\n", e) // e: struct { a struct { x int }; main.Integer }{a:struct { x int }{x:0}, Integer:444}
846 | }
847 |
848 | // 函数参数为匿名结构体类型时,传入参数类型声明必须保持一致
849 | func printa(s struct{}) {
850 | fmt.Printf("a: %#v\n", s) // a: struct {}{}
851 | }
852 |
853 | // 函数入参和返回值都支持匿名结构体类型
854 | func printb(s struct{ x int }) (x struct{ y byte }) {
855 | fmt.Printf("b: %#v\n", s) // b: struct { x int }{x:1}
856 | x.y = 25
857 | return
858 | }
859 |
860 | func printc(s struct {u int; v bool }) {
861 | fmt.Printf("c: %#v\n", s) // c: struct { u int; v bool }{u:0, v:false}
862 | }
863 | ```
864 |
865 | ### **指针 Pointer**
866 |
867 | - 通过取地址操作符`&`获取指向值/引用对象的指针。
868 |
869 | ```go
870 | var i int = 1
871 | pi := &i // 指向数值的指针
872 |
873 | a := []int{0, 1, 2}
874 | pa := &a // 指向引用对象的指针
875 |
876 | var s *S = &S{0, "1", "2"} // 指向值对象的指针
877 | ```
878 |
879 | - 内置函数`new(T)`分配了一个零初始化的 T 值,并返回指向它的指针
880 |
881 | ```go
882 | var i = new(int)
883 | var s *S = new(S)
884 | ```
885 |
886 | - 使用`*`读取/修改指针指向的值
887 |
888 | ```go
889 | func main() {
890 | i := new(int)
891 | *i = 3
892 | println(i, *i) // 0xc208031f80 3
893 |
894 | i = new(int)
895 | println(i, *i) // 0xc208031f78 0
896 | }
897 | ```
898 |
899 | - 指针使用点号来访问结构体字段
900 | 结构体字段/方法可以通过结构体指针来访问,通过指针间接的访问是透明的。
901 |
902 | ```go
903 | fmt.Println(s.A)
904 | fmt.Println((*s).A)
905 | ```
906 |
907 | - 指针的指针
908 |
909 | ```go
910 | func main() {
911 | var i int
912 | var p *int
913 | var pp **int
914 | var ppp ***int
915 | var pppp ****int
916 | println(i, p, pp, ppp, pppp) // 0 0x0 0x0 0x0 0x0
917 |
918 | i, p, pp, ppp, pppp = 123, &i, &p, &pp, &ppp
919 | println(i, p, pp, ppp, pppp) // 123 0xc208031f68 0xc208031f88 0xc208031f80 0xc208031f78
920 | println(i, *p, **pp, ***ppp, ****pppp) // 123 123 123 123 123
921 | }
922 | ```
923 |
924 | - 跨层指针元素的使用
925 | 在指针引用多层对象时,指针是针对引用表达式的最后一位元素。
926 |
927 | ```go
928 | package a
929 |
930 | type X struct {
931 | A Y
932 | }
933 | type Y struct {
934 | B Z
935 | }
936 | type Z struct {
937 | C int
938 | }
939 | ```
940 |
941 | ```go
942 | package main
943 | import (
944 | "a"
945 | "fmt"
946 | )
947 |
948 | func main() {
949 | var x = a.X{}
950 | var p = &x
951 | fmt.Println("x: ", x) // x: {{{0}}}
952 | println("p: ", p) // p: 0xc208055f20
953 | fmt.Println("*p: ", *p) // *p: {{{0}}}
954 | println("x.A.B.C: ", x.A.B.C) // x.A.B.C: 0
955 | // println("*p.A.B.C: ", *p.A.B.C) // invalid indirect of p.A.B.C (type int)
956 | println("(*p).A.B.C: ", (*p).A.B.C) // (*p).A.B.C: 0
957 | }
958 | ```
959 |
960 | - Go的指针没有指针运算,但是 **道高一尺,魔高一丈**
961 | [Go语言中的指针运算](http://1234n.com/?post/rseosp)
962 | [利用unsafe操作未导出变量](http://my.oschina.net/goal/blog/193698)
963 |
964 | ### **通道 Channel, keyword:`chan`**
965 |
966 | - channel用于两个goroutine之间传递指定类型的值来同步运行和通讯。
967 | 操作符`<-`用于指定channel的方向,发送或接收。
968 | 如果未指定方向,则为双向channel。
969 |
970 | ```go
971 | var c0 chan int // 可用来发送和接收int类型的值
972 | var c1 chan<- int // 可用来发送int类型的值
973 | var c2 <-chan int // 可用来接收int类型的值
974 | ```
975 |
976 | - channel是引用类型,使用`make`函数来初始化。
977 | 未初始化的channel零值是`nil`,且不能用于发送和接收值。
978 |
979 | ```go
980 | c0 := make(chan int) // 不带缓冲的int类型channel
981 | c1 := make(chan *int, 10) // 带缓冲的*int类型指针channel
982 | ```
983 | 无缓冲的channel没有接收者时发送方会阻塞,直到有接收方从channel中取出值。
984 | 带缓冲的channel在缓冲区已满时发送方会阻塞,直到接收方从channel中取出值。
985 | 接收方在channel中无值会一直阻塞。
986 |
987 | - 通过channel发送一个值时,`<-`作为二元操作符使用,
988 |
989 | ```go
990 | c0 <- 3
991 | ```
992 |
993 | 通过channel接收一个值时,`<-`作为一元操作符使用。
994 |
995 | ```go
996 | i := <-c1
997 | ```
998 |
999 | - 关闭channel,只能用于双向或只发送类型的channel
1000 | 只能由 **发送方**调用`close`函数来关闭channel
1001 | 接收方取出已关闭的channel中发送的值后,后续再从channel中取值时会以非阻塞的方式立即返回channel传递类型的零值。
1002 |
1003 | ```go
1004 | ch := make(chan string, 1)
1005 |
1006 | // 发送方,发送值后关闭channel
1007 | ch <- "hello"
1008 | close(ch)
1009 |
1010 |
1011 | // 接收方,取出发送的值
1012 | fmt.Println(<-ch) // 输出: “hello”
1013 |
1014 | // 再次从已关闭的channel中取值,返回channel传递类型的零值
1015 | fmt.Println(<-ch) // 输出: 零值,空字符串“”
1016 |
1017 | // 接收方判断接收到的零值是由发送方发送的还是关闭channel返回的默认值
1018 | s, ok := <-ch
1019 | if ok {
1020 | fmt.Println("Receive value from sender:", s)
1021 | } else {
1022 | fmt.Println("Get zero value from closed channel")
1023 | }
1024 |
1025 | // 向已关闭的通道发送值会产生运行时恐慌panic
1026 | ch <- "hi"
1027 | // 再次关闭已经关闭的通道也会产生运行时恐慌panic
1028 | close(ch)
1029 | ```
1030 |
1031 | - 使用`for range`语句依次读取发送到channel的值,直到channel关闭。
1032 |
1033 | ```go
1034 | package main
1035 |
1036 | import "fmt"
1037 |
1038 | func main() {
1039 | // 无缓冲和有缓冲的channel的range用法相同
1040 | var ch = make(chan int) // make(chan int, 2) 或 make(chan int , 100)
1041 | go func() {
1042 | for i := 0; i < 5; i++ {
1043 | ch <- i
1044 | }
1045 | close(ch)
1046 | }()
1047 |
1048 | // channel中无发送值且未关闭时会阻塞
1049 | for x := range ch {
1050 | fmt.Println(x)
1051 | }
1052 | }
1053 | ```
1054 |
1055 | 下面方式与for range用法效果相同
1056 |
1057 | ```go
1058 | loop:
1059 | for {
1060 | select {
1061 | case x, ok := <-c:
1062 | if !ok {
1063 | break loop
1064 | }
1065 | fmt.Println(x)
1066 | }
1067 | }
1068 | ```
1069 |
1070 | ### **接口 Interface, keyword:`interface`**
1071 |
1072 | - 接口类型是由一组类型定义的集合。
1073 | 接口类型的值可以存放实现这些方法的任何值。
1074 |
1075 | ```go
1076 | type Abser interface {
1077 | Abs() float64
1078 | }
1079 | ```
1080 |
1081 | - 类型通过实现定义的方法来实现接口, 不需要显式声明实现某接口。
1082 |
1083 | ```go
1084 | type MyFloat float64
1085 |
1086 | func (f MyFloat) Abs() float64 {
1087 | if f < 0 {
1088 | return float64(-f)
1089 | }
1090 | return float64(f)
1091 | }
1092 | ```
1093 |
1094 | - 接口组合
1095 |
1096 | ```go
1097 | type Reader interface {
1098 | Read(b []byte) (n int)
1099 | }
1100 |
1101 | type Writer interface {
1102 | Write(b []byte) (n int)
1103 | }
1104 |
1105 | // 接口ReadWriter组合了Reader和Writer两个接口
1106 | type ReadWriter interface {
1107 | Reader
1108 | Writer
1109 | }
1110 |
1111 | type File struct {
1112 | // ...
1113 | }
1114 |
1115 | func (f *File) Read(b []byte) (n int) {
1116 | println("Read", len(b),"bytes data.")
1117 | return len(b)
1118 | }
1119 |
1120 | func (f *File) Write(b []byte) (n int) {
1121 | println("Write", len(b),"bytes data.")
1122 | return len(b)
1123 | }
1124 |
1125 | func main() {
1126 | // *File 实现了Read方法和Write方法,所以实现了Reader接口和Writer接口以及组合接口ReadWriter
1127 | var f *File = &File{}
1128 | var r Reader = f
1129 | var w Writer = f
1130 | var rw ReadWriter = f
1131 | bs := []byte("asdf")
1132 | r.Read(bs)
1133 | rw.Read(bs)
1134 | w.Write(bs)
1135 | rw.Write(bs)
1136 | }
1137 | ```
1138 |
1139 | - 内置接口类型`error`是一个用于表示错误情况的常规接口,其零值`nil`表示没有错误
1140 | 所有实现了`Error`方法的类型都能表示为一个错误
1141 |
1142 | ```go
1143 | type error interface {
1144 | Error() string
1145 | }
1146 | ```
1147 |
1148 | ### **自定义类型**
1149 |
1150 | - Go中支持自定义的类型可基于: 基本类型、数组类型、切片类型、字典类型、函数类型、结构体类型、通道类型、接口类型以及自定义类型的类型
1151 |
1152 | ```go
1153 | type (
1154 | A int
1155 | B int8
1156 | C int16
1157 | D rune
1158 | E int32
1159 | F int64
1160 | G uint
1161 | H byte
1162 | I uint16
1163 | J uint32
1164 | K uint64
1165 | L float32
1166 | M float64
1167 | N complex64
1168 | O complex128
1169 | P uintptr
1170 | Q bool
1171 | R string
1172 | S [3]uint8
1173 | T []complex128
1174 | U map[string]uintptr
1175 | V func(i int) (b bool)
1176 | W struct {a, b int}
1177 | X chan int
1178 | Y any
1179 | Z A
1180 | )
1181 | ```
1182 |
1183 | - 以及支持以上所有支持类型的指针类型
1184 |
1185 | ```go
1186 | type (
1187 | A *int
1188 | B *int8
1189 | C *int16
1190 | D *rune
1191 | E *int32
1192 | F *int64
1193 | G *uint
1194 | H *byte
1195 | I *uint16
1196 | J *uint32
1197 | K *uint64
1198 | L *float32
1199 | M *float64
1200 | N *complex64
1201 | O *complex128
1202 | P *uintptr
1203 | Q *bool
1204 | R *string
1205 | S *[3]uint8
1206 | T *[]complex128
1207 | U *map[string]uintptr
1208 | V *func(i int) (b bool)
1209 | W *struct {a, b int}
1210 | X *chan int
1211 | Y *any
1212 | Z *A
1213 | )
1214 | ```
1215 |
1216 | - 类型别名 `Go1.9+`
1217 |
1218 | ```go
1219 | type (
1220 | A struct{}
1221 | B struct{} // 定义两个结构相同的类型A,B
1222 | C = A // 定义类型A的别名
1223 | )
1224 |
1225 | func main() {
1226 | var (
1227 | a A
1228 | b B
1229 | c C
1230 | )
1231 | // 因为类型名不同,所以a和b不是相同类型,此处编译错误
1232 | fmt.Println(a == b) // ❌invalid operation: a == b (mismatched types A and B)
1233 |
1234 | fmt.Println(a == c) // true
1235 | a = C{}
1236 | c = A{}
1237 | fmt.Println(c == a) // true
1238 | }
1239 | ```
1240 |
1241 | - 强制类型转换
1242 |
1243 | 数据类型转换语法规则
1244 |
1245 | ```go
1246 | // T 为新的数据类型
1247 | newDataTypeVariable = T(oldDataTypeVariable)
1248 | ```
1249 |
1250 | 数值类型转换
1251 |
1252 | ```go
1253 | var i int = 123
1254 | var f = float64(i)
1255 | var u = uint(f)
1256 | ```
1257 |
1258 | 接口类型转换
1259 | 任意类型的数据都可以转换为其类型已实现的接口类型
1260 |
1261 | ```go
1262 | type I any
1263 |
1264 | var x int = 123
1265 | var y = I(x)
1266 |
1267 | var s struct{a string}
1268 | var t = I(s)
1269 | ```
1270 |
1271 | 结构体类型转换 `Go1.8+`
1272 | 如果两个结构体包含的所有字段的名称和类型相同(忽略字段的标签差异),则可以互相强制转换类型。
1273 |
1274 | ```go
1275 | type T1 struct {
1276 | X int `json:"foo"`
1277 | }
1278 |
1279 | type T2 struct {
1280 | X int `json:"bar"`
1281 | }
1282 |
1283 | var v1 = T1{X: 123}
1284 | var v2 = T2(v1)
1285 | ```
1286 |
1287 | ## **语句 Statement**
1288 |
1289 | ### **分号/括号 ; {**
1290 |
1291 | - Go是采用语法解析器自动在每行末尾增加分号,所以在写代码的时候可以省略分号。
1292 |
1293 | - Go编程中只有几个地方需要手工增加分号:
1294 | for循环使用分号把初始化、条件和遍历元素分开。
1295 | if/switch的条件判断带有初始化语句时使用分号分开初始化语句与判断语句。
1296 | 在一行中有多条语句时,需要增加分号。
1297 |
1298 | - 控制语句(if,for,switch,select)、函数、方法 的左大括号不能单独放在一行, 语法解析器会在大括号之前自动插入一个分号,导致编译错误。
1299 |
1300 | ### **条件语句 if, keyword:`if` `else`**
1301 |
1302 | - `if`语句 小括号 ( )是可选的,而大括号 { } 是必须的。
1303 |
1304 | ```go
1305 | if (i < 0) // ❌编译错误.
1306 | println(i)
1307 |
1308 | if i < 0 // ❌编译错误.
1309 | println(i)
1310 |
1311 | if (i < 0) { // 编译通过.
1312 | println(i)
1313 | }
1314 |
1315 | if (i < 0 || i > 10) {
1316 | println(i)
1317 | }
1318 |
1319 | if i < 0 {
1320 | println(i)
1321 | } else if i > 5 && i <= 10 {
1322 | println(i)
1323 | } else {
1324 | println(i)
1325 | }
1326 | ```
1327 |
1328 | - 可以在条件之前执行一个简单的语句,由这个语句定义的变量的作用域仅在 if / else if / else 范围之内
1329 |
1330 | ```go
1331 | if (i := 0; i < 1) { // ❌编译错误.
1332 | println(i)
1333 | }
1334 |
1335 | if i := 0; (i < 1) { // 编译通过.
1336 | println(i)
1337 | }
1338 |
1339 | if i := 0; i < 0 { // 使用gofmt格式化代码会自动移除代码中不必要的小括号( )
1340 | println(i)
1341 | } else if i == 0 {
1342 | println(i)
1343 | } else {
1344 | println(i)
1345 | }
1346 | ```
1347 |
1348 | - `if`语句作用域范围内定义的变量会覆盖外部同名变量,与方法函数内局部变量覆盖全局变量同理
1349 |
1350 | ```go
1351 | a, b := 0, 1
1352 | if a, b := 3, 4; a > 1 && b > 2 {
1353 | println(a, b) // 3 4
1354 | }
1355 | println(a, b) // 0 1
1356 | ```
1357 |
1358 | - `if`判断语句类型断言
1359 |
1360 | ```go
1361 | package main
1362 |
1363 | func f0() int {return 333}
1364 |
1365 | func main() {
1366 | x := 9
1367 | checkType(x)
1368 | checkType(f0)
1369 | }
1370 |
1371 | func checkType(x any) {
1372 | // 断言传入的x为int类型,并获取值
1373 | if i, ok := x.(int); ok {
1374 | println("int: ", i) // int: 0
1375 | }
1376 |
1377 | if f, ok := x.(func() int); ok {
1378 | println("func: ", f()) // func: 333
1379 | }
1380 |
1381 | // 如果传入x类型为int,则可以直接获取其值
1382 | a := x.(int)
1383 | println(a)
1384 |
1385 | // 如果传入x类型不是byte,则会产生恐慌panic
1386 | b := x.(byte)
1387 | println(b)
1388 | }
1389 | ```
1390 |
1391 | ### **分支选择 switch, keyword:`switch` `case` `default` `fallthrough`**
1392 |
1393 | - `switch`存在分支选择对象时,`case`分支支持单个常量、常量列表
1394 |
1395 | ```go
1396 | switch x {
1397 | case 0:
1398 | println("single const")
1399 | case 1, 2, 3:
1400 | println("const list")
1401 | default:
1402 | println("default")
1403 | }
1404 | ```
1405 |
1406 | - 分支选择对象可以是一个表达式或语句的结果
1407 |
1408 | ```go
1409 | switch len(myIP) == net.IPv4len {
1410 | case true:
1411 | println("IPv4")
1412 | case false:
1413 | println("IPv6")
1414 | }
1415 |
1416 | switch isOddNumber(rand.Int()) {
1417 | case true:
1418 | println("Odd number")
1419 | case false:
1420 | println("Even Number")
1421 | }
1422 | ```
1423 |
1424 | - 分支选择对象之前可以有一个简单语句,case语句的大括号可以省略
1425 |
1426 | ```go
1427 | switch x *= 2; x {
1428 | case 4: {
1429 | println("single const")
1430 | }
1431 | case 5, 6, 7: {
1432 | println("const list")
1433 | }
1434 | default: {
1435 | println("default")
1436 | }
1437 | }
1438 | ```
1439 |
1440 | - `switch`只有一个简单语句,没有分支选择对象时,case分支支持逻辑表达式语句
1441 |
1442 | ```go
1443 | switch x /= 3; {
1444 | case x == 8:
1445 | println("expression")
1446 | case x >= 9:
1447 | println("expression")
1448 | default:
1449 | println("default")
1450 | }
1451 | ```
1452 |
1453 | - `switch`没有简单语句,没有分支选择对象时,case分支支持逻辑表达式语句
1454 |
1455 | ```go
1456 | switch {
1457 | case x == 10:
1458 | println("expression")
1459 | case x >= 11:
1460 | println("expression")
1461 | default:
1462 | println("default")
1463 | }
1464 | ```
1465 |
1466 | - `switch`类型分支,只能在switch语句中使用的`.(type)`获取对象的类型。
1467 |
1468 | ```go
1469 | package main
1470 |
1471 | import (
1472 | "fmt"
1473 | "go/types"
1474 | )
1475 |
1476 | func main() {
1477 | var (
1478 | a = 0.1
1479 | b = 2+3i
1480 | c = "asdf"
1481 | d = [...]byte{1, 2, 3}
1482 | e = []complex128{1+2i}
1483 | f = map[string]uintptr{"a": 0}
1484 | g = func(int) bool {return true}
1485 | h = struct { a, b int }{}
1486 | i = &struct {}{}
1487 | j chan int
1488 | k chan <- bool
1489 | l <-chan string
1490 | m types.Error
1491 | )
1492 |
1493 | values := []any{nil, a, b, &c, d, e, f, g, &g, h, &h, i, j, k, l, m}
1494 | for _, v := range values {
1495 | typeswitch(v)
1496 | }
1497 | }
1498 |
1499 | func typeswitch(x any) {
1500 | // switch x.(type) { // 不使用类型值时
1501 | switch i := x.(type) {
1502 | case nil:
1503 | fmt.Println("x is nil")
1504 | case int, int8, int16, rune, int64, uint, byte, uint16, uint32, uint64, float32, float64, complex64, complex128, uintptr, bool, string:
1505 | fmt.Printf("basic type : %T\n", i)
1506 | case *int, *int8, *int16, *rune, *int64, *uint, *byte, *uint16, *uint32, *uint64, *float32, *float64, *complex64, *complex128, *uintptr, *bool, *string:
1507 | fmt.Printf("basic pointer type : %T\n", i)
1508 | case [3]byte, []complex128, map[string]uintptr:
1509 | fmt.Printf("collection type : %T\n", i)
1510 | case func(i int) (b bool), *func():
1511 | fmt.Printf("function type : %T\n", i)
1512 | case struct {a, b int}, *struct {}:
1513 | fmt.Printf("struct type : %T\n", i)
1514 | case chan int, chan <- bool, <-chan string:
1515 | fmt.Printf("channel type : %T\n", i)
1516 | case error, interface{a(); b()}:
1517 | fmt.Printf("interface type : %T\n", i)
1518 | default:
1519 | fmt.Printf("other type : %T\n", i)
1520 | }
1521 | }
1522 |
1523 | // output:
1524 |
1525 | // x is nil
1526 | // basic type : float64
1527 | // basic type : complex128
1528 | // basic pointer type : *string
1529 | // collection type : [3]uint8
1530 | // collection type : []complex128
1531 | // collection type : map[string]uintptr
1532 | // function type : func(int) bool
1533 | // other type : *func(int) bool
1534 | // struct type : struct { a int; b int }
1535 | // other type : *struct { a int; b int }
1536 | // struct type : *struct {}
1537 | // channel type : chan int
1538 | // channel type : chan<- bool
1539 | // channel type : <-chan string
1540 | // interface type : errors.SignatureError
1541 | ```
1542 |
1543 | - `switch`中每个case分支默认带有break效果,一个分支执行后就跳出switch,不会自动向下执行其他case。
1544 | 使用`fallthrough`强制向下继续执行后面的case代码。
1545 | 在类型分支中不允许使用`fallthrough`语句
1546 |
1547 | ```go
1548 | switch {
1549 | case false:
1550 | println("case 1")
1551 | fallthrough
1552 | case true:
1553 | println("case 2")
1554 | fallthrough
1555 | case false:
1556 | println("case 3")
1557 | fallthrough
1558 | case true:
1559 | println("case 4")
1560 | case false:
1561 | println("case 5")
1562 | fallthrough
1563 | default:
1564 | println("default case")
1565 | }
1566 | // 输出:case 2 case 3 case 4
1567 | ```
1568 |
1569 | ### **循环语句 for, keyword:`for` `range` `continue` `break`**
1570 |
1571 | - Go只有一种循环结构:`for` 循环。
1572 | 可以让前置(初始化)、中间(条件)、后置(迭代)语句为空,或者全为空。
1573 |
1574 | ```go
1575 | for i := 0; i < 10; i++ {...}
1576 | for i := 0; i < 10; {...} // 省略迭代语句
1577 | for i := 0; ; i++; {...} // 省略条件语句
1578 | for ; i < 10; i++ {...} // 省略初始化语句
1579 | for i := 0; ; {...} // 省略条件和迭代语句, 分号不能省略
1580 | for ; i < 10; {...} // 省略初始化和迭代语句, 分号可省略
1581 | for ; ; i++ {...} // 省略初始化和条件语句, 分号不能省略
1582 | for i < 10 {...}
1583 | for ; ; {...} // 分号可省略
1584 | for {...}
1585 | ```
1586 |
1587 | - `for`语句中小括号 ( )是可选的,而大括号 { } 是必须的。
1588 |
1589 | ```go
1590 | for (i := 0; i < 10; i++) {...} // ❌编译错误.
1591 | for i := 0; (i < 10); i++ {...} // 编译通过.
1592 | for (i < 10) {...} // 编译通过.
1593 | ```
1594 |
1595 | - Go的for each循环`for range`
1596 |
1597 | ```go
1598 | a := [5]int{2, 3, 4, 5, 6}
1599 |
1600 | for k, v := range a {
1601 | fmt.Println(k, v) // 输出:0 2, 1 3, 2 4, 3 5, 4 6
1602 | }
1603 |
1604 | for k := range a {
1605 | fmt.Println(k) // 输出:0 1 2 3 4
1606 | }
1607 |
1608 | for _ = range a {
1609 | fmt.Println("print without care about the key and value")
1610 | }
1611 | ```
1612 |
1613 | `Go1.4+`
1614 | ```go
1615 | for range a {
1616 | fmt.Println("new syntax – print without care about the key and value")
1617 | }
1618 | ```
1619 |
1620 | - 循环的继续、中断、跳转
1621 |
1622 | ```go
1623 | for k, v := range s {
1624 | if v == 3 {
1625 | continue // 结束本次循环,进入下一次循环中
1626 | } else if v == 5 {
1627 | break // 结束整个for循环
1628 | } else {
1629 | goto SOMEWHERE // 跳转到标签指定的代码处
1630 | }
1631 | }
1632 | ```
1633 |
1634 | - `for range`只支持遍历`数组`、`数组指针`、`slice`、`string`、`map`、`channel`类型
1635 | 新增支持遍历整数类型,迭代从0到n-1递增的数字`Go1.22+`
1636 | 新增支持遍历函数迭代器`Go1.23+`
1637 |
1638 | ```go
1639 | package main
1640 |
1641 | import (
1642 | "fmt"
1643 | "slices"
1644 | )
1645 |
1646 | func main() {
1647 | var arr = [...]int{33, 22, 11, 0}
1648 | // 遍历数组,取一位值时为索引值
1649 | for k := range arr {
1650 | fmt.Printf("%d, ", k) // 0, 1, 2, 3,
1651 | }
1652 | fmt.Println()
1653 | // 遍历数组,取两位值时,第一位为索引值,第二位为元素值
1654 | for k, v := range arr {
1655 | fmt.Printf("%d %d, ", k, v) // 0 33, 1 22, 2 11, 3 0,
1656 | }
1657 | fmt.Println()
1658 |
1659 | // 遍历数组指针,取一位值时为索引值
1660 | for k := range &arr {
1661 | fmt.Printf("%d, ", k) // 0, 1, 2, 3,
1662 | }
1663 | fmt.Println()
1664 | // 遍历数组指针,取两位值时,第一位为索引值,第二位为元素值
1665 | for k, v := range &arr {
1666 | fmt.Printf("%d %d, ", k, v) // 0 33, 1 22, 2 11, 3 0,
1667 | }
1668 | fmt.Println()
1669 |
1670 | var slc = []byte{44, 55, 66, 77}
1671 | // 遍历切片,取一位值时为索引值
1672 | for k := range slc {
1673 | fmt.Printf("%d, ", k) // 0, 1, 2, 3,
1674 | }
1675 | fmt.Println()
1676 | // 遍历切片,取两位值时,第一位为索引值,第二位为元素值
1677 | for k, v := range slc {
1678 | fmt.Printf("%d %d, ", k, v) // 0 44, 1 55, 2 66, 3 77,
1679 | }
1680 | fmt.Println()
1681 |
1682 | var str = "abc一二3"
1683 | // 遍历字符串,取一位值时为字节索引值
1684 | for k := range str {
1685 | fmt.Printf("%d, ", k) // 0, 1, 2, 3, 6, 9,
1686 | }
1687 | fmt.Println()
1688 | // 遍历字符串,取两位值时,第一位为字节索引值,第二位为Unicode字符
1689 | for k, v := range str {
1690 | fmt.Printf("%d %d %s, ", k, v, string(v)) // 0 97 a, 1 98 b, 2 99 c, 3 19968 一, 6 20108 二, 9 51 3,
1691 | }
1692 | fmt.Println()
1693 |
1694 | var mp = map[int]string{5:"A", 9:"B"}
1695 | // 遍历map,取一位值时为键key
1696 | for k := range mp {
1697 | fmt.Printf("%d, ", k) // 9, 5,
1698 | }
1699 | fmt.Println()
1700 | // 遍历map,取两位值时,第一位为键key,第二位为元素值value
1701 | for k, v := range mp {
1702 | fmt.Printf("%d %s, ", k, v) // 5 A, 9 B,
1703 | }
1704 | fmt.Println()
1705 |
1706 | var ch = make(chan int)
1707 | go func() {
1708 | for i := 0; i < 5; i++ {
1709 | ch <- i
1710 | }
1711 | close(ch)
1712 | }()
1713 | // 遍历channel时,只能取一位值,为发送方发送到channel中的值
1714 | for x := range ch {
1715 | fmt.Printf("%d ", x) // 0 1 2 3 4
1716 | }
1717 | // 遍历整数时,只能取一位值,为从0到n-1之间的递增整数, 如果n<=0则不会执行遍历 Go1.22+
1718 | for i := range 5 {
1719 | fmt.Printf("%d ", i) // 0 1 2 3 4
1720 | }
1721 | // 遍历函数迭代器 Go1.23+
1722 | for v := range slices.Values([]int{1, 2, 3, 4, 5}) {
1723 | fmt.Println(v)
1724 | }
1725 | for i, v := range slices.Backward([]int{1, 2, 3, 4, 5}) {
1726 | fmt.Println(i, v)
1727 | }
1728 | }
1729 | ```
1730 |
1731 | ### **通道选择 select, keyword:`select`**
1732 |
1733 | - ` select`用于当前goroutine从一组可能的通讯中选择一个进一步处理。
1734 | 如果任意一个通讯都可以进一步处理,则从中随机选择一个,执行对应的语句。否则在没有默认分支(default case)时,select语句则会阻塞,直到其中一个通讯完成。
1735 | select 的 case 里的操作语句只能是IO操作
1736 |
1737 | ```go
1738 | ch1, ch2 := make(chan int), make(chan int)
1739 |
1740 | // 因为没有值发送到select中的任一case的channel中,此select将会阻塞
1741 | select {
1742 | case <-ch1:
1743 | println("channel 1")
1744 | case <-ch2:
1745 | println("channel 2")
1746 | }
1747 | ```
1748 |
1749 | ```go
1750 | ch1, ch2 := make(chan int), make(chan int)
1751 |
1752 | // 因为没有值发送到select中的任一case的channel中,此select将会执行default分支
1753 | select {
1754 | case <-ch1:
1755 | println("channel 1")
1756 | case <-ch2:
1757 | println("channel 2")
1758 | default:
1759 | println("default")
1760 | }
1761 | ```
1762 |
1763 | - select只会执行一次case分支的逻辑,与`for`组合使用实现多次遍历分支
1764 |
1765 | ```go
1766 | func main() {
1767 | for {
1768 | select {
1769 | case <-time.Tick(time.Second):
1770 | println("Tick")
1771 | case <-time.After(5 * time.Second):
1772 | println("Finish")
1773 | default:
1774 | println("default")
1775 | time.Sleep(5e8)
1776 | }
1777 | }
1778 |
1779 | ctx, cancel := context.WithTimeout(context.Background(), time.Second)
1780 | defer cancel()
1781 | loop:
1782 | for {
1783 | select {
1784 | case <-ctx.Done():
1785 | println("Tick")
1786 | break loop
1787 | case <-time.After(5 * time.Second):
1788 | println("Finish")
1789 | break loop
1790 | default:
1791 | println("default")
1792 | time.Sleep(5e8)
1793 | }
1794 | }
1795 | }
1796 | ```
1797 |
1798 | - select没有case分支可供选择执行时该调用会被永久阻塞,在其之后的语句将不会被执行
1799 |
1800 | ```go
1801 | select {}
1802 | ```
1803 |
1804 | ### **延迟执行 defer, keyword:`defer`**
1805 |
1806 | - `defer`语句调用函数,将调用的函数加入defer栈,栈中函数在defer所在的主函数返回时执行,执行顺序是先进后出/后进先出。
1807 |
1808 | ```go
1809 | package main
1810 |
1811 | func main() {
1812 | defer print(0)
1813 | defer print(1)
1814 | defer print(2)
1815 | defer print(3)
1816 | defer print(4)
1817 |
1818 | for i := 5; i <= 9; i++ {
1819 | defer print(i)
1820 | }
1821 | // 输出:9876543210
1822 | }
1823 | ```
1824 |
1825 | - defer在函数返回后执行,可以修改函数返回值
1826 |
1827 | ```go
1828 | package main
1829 |
1830 | func main() {
1831 | println(f()) // 返回: 15
1832 | }
1833 |
1834 | func f() (i int) {
1835 | defer func() {
1836 | i *= 5
1837 | }()
1838 | return 3
1839 | }
1840 | ```
1841 |
1842 | - defer用于释放资源
1843 |
1844 | 释放锁
1845 | ```go
1846 | mu.Lock()
1847 | defer mu.Unlock()
1848 | ```
1849 |
1850 | 关闭channel
1851 |
1852 | ```go
1853 | ch <- "hello"
1854 | defer close(ch)
1855 | ```
1856 |
1857 | 关闭IO流
1858 |
1859 | ```go
1860 | f, err := os.Open("file.xxx")
1861 | defer f.Close()
1862 | ```
1863 |
1864 | 关闭数据库连接
1865 |
1866 | ```go
1867 | db, err := sql.Open("mysql","user:password@tcp(127.0.0.1:3306)/hello")
1868 | if err != nil {
1869 | log.Fatal(err)
1870 | }
1871 | defer db.Close()
1872 | ```
1873 |
1874 | - defer用于恐慌的截获
1875 | `panic`用于产生恐慌,`recover`用于截获恐慌,recover只能在defer语句中使用, 直接调用recover是无效的。
1876 |
1877 | ```go
1878 | func main() {
1879 | f()
1880 | fmt.Println("main normal...")
1881 | }
1882 |
1883 | func f() {
1884 | defer func() {
1885 | if r := recover(); r != nil {
1886 | fmt.Println("catch:", r)
1887 | }
1888 | }()
1889 | p()
1890 | fmt.Println("normal...")
1891 | }
1892 |
1893 | func p() {
1894 | panic("exception...")
1895 | }
1896 | ```
1897 |
1898 | ### **跳转语句 goto, keyword:`goto`**
1899 |
1900 | - `goto`用于在一个函数内部运行跳转到指定标签的代码处,不能跳转到其他函数中定义的标签。
1901 |
1902 | - `goto`模拟循环
1903 |
1904 | ```go
1905 | package main
1906 |
1907 | func main() {
1908 | i := 0
1909 | loop:
1910 | i++
1911 | if i < 5 {
1912 | goto loop
1913 | }
1914 | println(i)
1915 | }
1916 | ```
1917 |
1918 | - `goto`模拟`continue`,`break`
1919 |
1920 | ```go
1921 | func main() {
1922 | i, sum := 0, 0
1923 | head:
1924 | for ; i <= 10; i++ {
1925 | if i < 5 {
1926 | i++ // 此处必须单独调用一次,因为goto跳转时不会执行for循环的自增语句
1927 | goto head // continue
1928 | }
1929 | if i > 9 {
1930 | goto tail // break
1931 | }
1932 | sum += i
1933 | }
1934 | tail:
1935 | println(sum) // 输出:35
1936 | }
1937 | ```
1938 |
1939 | - **注意**:任何时候都不建议使用`goto`
1940 |
1941 | ### 阻塞语句
1942 |
1943 | - 永久阻塞语句
1944 |
1945 | ```go
1946 | // 向一个未初始化的channel中写入数据会永久阻塞
1947 | (chan int)(nil) <- 0
1948 | // 从一个未初始化的channel中读取数据会永久阻塞
1949 | <-(chan struct{})(nil)
1950 | for range (chan struct{})(nil){}
1951 |
1952 | // select无任何选择分支会永久阻塞
1953 | select{}
1954 | ```
1955 |
1956 | ## **函数 Function**
1957 |
1958 | ### **函数声明 Declare, keyword:`func` `return`**
1959 |
1960 | - 使用关键字`func`声明函数,函数可以没有参数或接受多个参数
1961 |
1962 | ```go
1963 | func f0() {/*...*/}
1964 |
1965 | func f1(a int) {/*...*/}
1966 |
1967 | func f2(a int, b byte) {/*...*/}
1968 | ```
1969 |
1970 | - 在函数参数类型之前使用`...`声明该参数为可变数量的参数
1971 | 可变参数只能声明为函数的最后一个参数。
1972 |
1973 | ```go
1974 | func f3(a ...int) {/*...*/}
1975 |
1976 | func f4(a int, b bool, c ...string) {/*...*/}
1977 | ```
1978 |
1979 | - 函数可以返回任意数量的返回值
1980 |
1981 | ```go
1982 | func f0() {
1983 | return
1984 | }
1985 |
1986 | func f1() int {
1987 | return 0
1988 | }
1989 |
1990 | func f2() (int, string) {
1991 | return 0, "A"
1992 | }
1993 | ```
1994 |
1995 | - 函数返回结果参数,可以像变量那样命名和使用
1996 |
1997 | ```go
1998 | func f() (a int, b string) {
1999 | a = 1
2000 | b = "B"
2001 | return // 即使return后面没有跟变量,关键字在函数结尾也是必须的
2002 | // 或者 return a, b
2003 | }
2004 | ```
2005 |
2006 | - 当两个或多个连续的函数命名参数是同一类型,则除了最后一个类型之外,其他都可以省略
2007 |
2008 | ```go
2009 | func f0(a,b,c int) {/*...*/}
2010 |
2011 | func f1() (a,b,c int) {/*...*/}
2012 |
2013 | func f2(a,b int, c,d byte) (x,y int, z,s bool) {/*...*/}
2014 | ```
2015 |
2016 | ### **函数闭包 Closure**
2017 |
2018 | - 匿名函数、闭包、函数值
2019 | Go中函数作为第一类对象,可以作为值对象赋值给变量
2020 | 可以在函数体外/内定义匿名函数,命名函数不能嵌套定义到函数体内,只能定义在函数体外
2021 |
2022 | ```go
2023 | package main
2024 |
2025 | type Myfunc func(i int) int
2026 |
2027 | func f0(name string){
2028 | println(name)
2029 | }
2030 |
2031 | func main() {
2032 | var a = f0
2033 | a("hello") // hello
2034 |
2035 | var f1 Myfunc = func(i int) int {
2036 | return i
2037 | }
2038 | fmt.Println(f1(3)) // 3
2039 |
2040 | var f2 func() int = func() int {
2041 | return 0
2042 | }
2043 | fmt.Println(f2()) // 0
2044 |
2045 | // 省略部分关键字
2046 | var f3 func() = func() {/*...*/}
2047 | var f4 = func() {/*...*/}
2048 | f5 := func() {/*...*/}
2049 | }
2050 | ```
2051 |
2052 | ### **内建函数 Builtin**
2053 |
2054 | - `func append`
2055 |
2056 | ```go
2057 | func append(slice []Type, elems ...Type) []Type
2058 | ```
2059 |
2060 | > 内建函数append将元素追加到切片的末尾。若它有足够的容量,其目标就会重新切片以容纳新的元素。否则,就会分配一个新的基本数组。append返回更新后的切片,因此必须存储追加后的结果。
2061 |
2062 | ```go
2063 | slice = append(slice, elem1, elem2)
2064 | slice = append(slice, anotherSlice...)
2065 | ```
2066 |
2067 | > 作为特例,可以向一个字节切片append字符串,如下:
2068 |
2069 | ```go
2070 | slice = append([]byte("hello "), "world"...)
2071 | ```
2072 |
2073 |
2074 | - `func cap`
2075 |
2076 | ```go
2077 | func cap(v Type) int
2078 | ```
2079 |
2080 | > 内建函数cap返回 v 的容量,这取决于具体类型:
2081 | 数组:v中元素的数量,与 len(v) 相同
2082 | 数组指针:*v中元素的数量,与len(v) 相同
2083 | 切片:切片的容量(底层数组的长度);若 v为nil,cap(v) 即为零
2084 | 信道:按照元素的单元,相应信道缓存的容量;若v为nil,cap(v)即为零
2085 |
2086 |
2087 |
2088 | - `func clear` `Go1.21+`
2089 |
2090 | ```go
2091 | func clear[T ~[]Type | ~map[Type]Type1](t T)
2092 | ```
2093 |
2094 | > 内建函数clear清除映射和切片。如果参数类型是类型参数,则类型参数的类型集必须仅包含映射或切片类型,并且clear执行类型参数隐含的操作。
2095 | 映射:删除所有元素从而产生空的映射map。
2096 | 切片:将切片长度以内的所有元素设置为相应元素类型的零值。
2097 |
2098 |
2099 |
2100 | - `func close`
2101 |
2102 | ```go
2103 | func close(c chan<- Type)
2104 | ```
2105 |
2106 | > 内建函数close关闭信道,该通道必须为双向的或只发送的。它应当只由发送者执行,而不应由接收者执行,其效果是在最后发送的值被接收后停止该通道。在最后的值从已关闭的信道中被接收后,任何对其的接收操作都会无阻塞的成功。对于已关闭的信道,语句:
2107 |
2108 | ```go
2109 | x, ok := <-c // ok值为false
2110 | ```
2111 |
2112 |
2113 | - `func complex`
2114 |
2115 | ```go
2116 | func complex(r, i FloatType) ComplexType
2117 | ```
2118 |
2119 | > 使用实部r和虚部i生成一个复数。
2120 |
2121 | ```go
2122 | c := complex(1, 2)
2123 | fmt.Println(c) // (1+2i)
2124 | ```
2125 |
2126 |
2127 | - `func copy`
2128 |
2129 | ```go
2130 | func copy(dst, src []Type) int
2131 | ```
2132 |
2133 | > 内建函数copy将元素从来源切片复制到目标切片中,也能将字节从字符串复制到字节切片中。copy返回被复制的元素数量,它会是 len(src) 和 len(dst) 中较小的那个。来源和目标的底层内存可以重叠。
2134 |
2135 | ```go
2136 | a, b, c := []byte{1, 2, 3}, make([]byte, 2), 0
2137 | fmt.Println("a:", a, " b:", b, " c: ", c) // a: [1 2 3] b: [0 0] c: 0
2138 |
2139 | c = copy(b, a)
2140 | fmt.Println("a:", a, " b:", b, " c: ", c) // a: [1 2 3] b: [1 2] c: 2
2141 |
2142 | b = make([]byte, 5)
2143 | c = copy(b, a)
2144 | fmt.Println("a:", a, " b:", b, " c: ", c) // a: [1 2 3] b: [1 2 3 0 0] c: 3
2145 |
2146 | s := "ABCD"
2147 | c = copy(b, s)
2148 | fmt.Println("s:", s, " b:", b, " c: ", c) // s: ABCD b: [65 66 67 68 0] c: 4
2149 | ```
2150 |
2151 |
2152 | - `func delete`
2153 |
2154 | ```go
2155 | func delete(m map[Type]Type1, key Type)
2156 | ```
2157 |
2158 | > 内建函数delete按照指定的键将元素从映射中删除。若m为nil或无此元素,delete不进行操作。
2159 |
2160 | ```go
2161 | m := map[int]string{
2162 | 0: "A",
2163 | 1: "B",
2164 | 2: "C",
2165 | }
2166 | delete(m, 1)
2167 | fmt.Println(m) // map[2:C 0:A]
2168 |
2169 | delete(m, 3) // 此行代码执行没有任何操作,也不会报错。
2170 | ```
2171 |
2172 |
2173 | - `func imag`
2174 |
2175 | ```go
2176 | func imag(c ComplexType) FloatType
2177 | ```
2178 |
2179 | > 返回复数c的虚部。
2180 |
2181 | ```go
2182 | c := 2+5i
2183 | fmt.Println(imag(c)) // 5
2184 | ```
2185 |
2186 |
2187 | - `func len`
2188 |
2189 | ```go
2190 | func len(v Type) int
2191 | ```
2192 |
2193 | > 内建函数len返回 v 的长度,这取决于具体类型:
2194 | 数组:v中元素的数量
2195 | 数组指针:*v中元素的数量(v为nil时panic)
2196 | 切片、映射:v中元素的数量;若v为nil,len(v)即为零
2197 | 字符串:v中字节的数量,计算字符数量使用`utf8.RuneCountInString()`
2198 | 通道:通道缓存中队列(未读取)元素的数量;若v为 nil,len(v)即为零
2199 |
2200 |
2201 |
2202 | - `func make`
2203 |
2204 | ```go
2205 | func make(Type, size IntegerType) Type
2206 | ```
2207 |
2208 | > 内建函数make分配并初始化一个类型为切片、映射、或通道的对象。其第一个实参为类型,而非值。make的返回类型与其参数相同,而非指向它的指针。其具体结果取决于具体的类型:
2209 | 切片:size指定了其长度。该切片的容量等于其长度。切片支持第二个整数实参可用来指定不同的容量;它必须不小于其长度,因此 make([]int, 0, 10) 会分配一个长度为0,容量为10的切片。
2210 | 映射:初始分配的创建取决于size,但产生的映射长度为0。size可以省略,这种情况下就会分配一个小的起始大小。
2211 | 通道:通道的缓存根据指定的缓存容量初始化。若 size为零或被省略,该信道即为无缓存的。
2212 |
2213 |
2214 |
2215 | - `func max` `Go1.21+`
2216 |
2217 | ```go
2218 | func max[T cmp.Ordered](x T, y ...T) T
2219 | ```
2220 |
2221 | > 内建函数max返回可排序类型的批量参数中的最大值。至少需要一个参数。如果传入参数是浮点类型并且有任一参数为NaN,则返回 NaN。
2222 |
2223 |
2224 |
2225 | - `func min` `Go1.21+`
2226 |
2227 | ```go
2228 | func min[T cmp.Ordered](x T, y ...T) T
2229 | ```
2230 |
2231 | > 内建函数min返回可排序类型的批量参数中的最小值。至少需要一个参数。如果传入参数是浮点类型并且有任一参数为NaN,则返回 NaN。
2232 |
2233 |
2234 |
2235 | - `func new`
2236 |
2237 | ```go
2238 | func new(Type) *Type
2239 | ```
2240 |
2241 | > 内建函数new分配内存。其第一个实参为类型,而非值。其返回值为指向该类型的新分配的零值的指针。
2242 |
2243 |
2244 |
2245 | - `func panic`
2246 |
2247 | ```go
2248 | func panic(v any)
2249 | ```
2250 |
2251 | > 内建函数panic停止当前Go程的正常执行。当函数F调用panic时,F的正常执行就会立刻停止。F中defer的所有函数先入后出执行后,F返回给其调用者G。G如同F一样行动,层层返回,直到该Go程中所有函数都按相反的顺序停止执行。之后,程序被终止,而错误情况会被报告,包括引发该恐慌的实参值,此终止序列称为恐慌过程。
2252 |
2253 |
2254 |
2255 | - `func print`
2256 |
2257 | ```go
2258 | func print(args ...Type)
2259 | ```
2260 |
2261 | > 内建函数print以特有的方法格式化参数并将结果写入标准错误,用于自举和调试。
2262 |
2263 |
2264 |
2265 | - `func println`
2266 |
2267 | ```go
2268 | func println(args ...Type)
2269 | ```
2270 |
2271 | > println类似print,但会在参数输出之间添加空格,输出结束后换行。
2272 |
2273 |
2274 |
2275 | - `func real`
2276 |
2277 | ```go
2278 | func real(c ComplexType) FloatType
2279 | ```
2280 |
2281 | > 返回复数c的实部。
2282 |
2283 | ```go
2284 | c := 2+5i
2285 | fmt.Println(real(c)) // 2
2286 | ```
2287 |
2288 |
2289 | - `func recover`
2290 |
2291 | ```go
2292 | func recover() any
2293 | ```
2294 |
2295 | > 内建函数recover允许程序管理恐慌过程中的Go程。在defer的函数中,执行recover调用会取回传至panic调用的错误值,恢复正常执行,停止恐慌过程。若recover在defer的函数之外被调用,它将不会停止恐慌过程序列。在此情况下,或当该Go程不在恐慌过程中时,或提供给panic的实参为nil时,recover就会返回nil。
2296 |
2297 | ### **初始化函数 init**
2298 |
2299 | - `init`函数是用于程序执行前做包的初始化工作的函数
2300 | `init`函数的声明没有参数和返回值
2301 |
2302 | ```go
2303 | func init() {
2304 | // ...
2305 | }
2306 | ```
2307 |
2308 | - 一个package或go源文件可以包含零个或多个init函数
2309 |
2310 | ```go
2311 | package main
2312 |
2313 | func main() {
2314 | }
2315 |
2316 | func init() {
2317 | println("init1...")
2318 | }
2319 | func init() {
2320 | println("init2...")
2321 | }
2322 | func init() {
2323 | println("init3...")
2324 | }
2325 | ```
2326 |
2327 | - init函数被自动调用,在main函数之前执行,不能在其他函数中调用,显式调用会报错该函数未定义。
2328 |
2329 | ```go
2330 | func init() {
2331 | println("init...")
2332 | }
2333 |
2334 | func main() {
2335 | init() // undefined: init
2336 | }
2337 | ```
2338 |
2339 | - 所有`init`函数都会被自动调用,调用顺序如下:
2340 | 1. 同一个go文件的init函数调用顺序是 **从上到下**的
2341 | 2. 同一个package中按go源文件名字符串比较 **从小到大**顺序调用各文件中的init函数
2342 | 3. 不同的package,如果不相互依赖的,按照main包中 **先import的后调用**的顺序调用其包中的init函数
2343 | 4. 如果package存在依赖,则先调用最早被依赖的package中的init函数
2344 |
2345 | ### **方法 Method**
2346 |
2347 | - 通过指定函数的接收者receiver,将函数绑定到一个类型或类型的指针上,使这个函数成为该类型的方法。
2348 | 只能对命名类型和命名类型的指针编写方法。
2349 | 只能在定义命名类型的那个包编写其方法。
2350 | 不能对接口类型和接口类型的指针编写方法。
2351 | 方法的接收者receiver是类型的值时,编译器会隐式的生成一个同名方法,其接收者receiver为该类型的指针,反过来却不会。
2352 |
2353 | ```go
2354 | package main
2355 |
2356 | type A struct {
2357 | x, y int
2358 | }
2359 |
2360 | // 定义结构体的方法,'_'表示方法内忽略使用结构体、字段及其他方法
2361 | func (_ A) echo_A() {
2362 | println("(_ A)")
2363 | }
2364 |
2365 | // 同上
2366 | func (A) echoA(s string) {
2367 | println("(A)", s)
2368 | }
2369 |
2370 | // 定义结构体指针的方法,'_'表示方法内忽略使用结构体指针、字段及其他方法
2371 | func (_ *A) echo_жA() {
2372 | println("(_ *A)")
2373 | }
2374 |
2375 | // 同上
2376 | func (*A) echoжA(s string) {
2377 | println("(*A)", s)
2378 | }
2379 |
2380 | // 定义结构体的方法,方法内可以引用结构体、字段及其他方法
2381 | func (a A) setX(x int) {
2382 | a.x = x
2383 | }
2384 |
2385 | // 定义结构体指针的方法,方法内可以引用结构体、结构体指针、字段及其他方法
2386 | func (a *A) setY(y int) {
2387 | a.y = y
2388 | }
2389 |
2390 | func main() {
2391 | var a A // a = A{}
2392 | a.setX(3)
2393 | a.setY(6)
2394 | println(a.x, a.y) // 0 6
2395 | a.echo_A() // (_ A)
2396 | a.echoA("a") // (A) a
2397 | a.echo_жA() // (_ *A)
2398 | a.echoжA("a") // (*A) a
2399 |
2400 | // 以下是定义在结构体值上的方法原型,通过调用结构体类型上定义的函数,传入结构体的值
2401 | A.echo_A(a) // (_ A)
2402 | A.echoA(a, "a") // (A) a
2403 | // A.echo_жA(a) // A.echo_жA未定义
2404 | // A.echoжA(a) // A.echoжA未定义
2405 | type AA = *A
2406 | AA.echo_жA(nil) // (_ *A)
2407 | A.setX(a, 4)
2408 | // A.setY(a, 7) // A.setY未定义
2409 | println(a.x) // 0
2410 |
2411 |
2412 | b := &a
2413 | b.setX(2)
2414 | b.setY(5)
2415 | println(b.x, b.y) // 0 5
2416 | b.echo_A() // (_ A)
2417 | b.echoA("b") // (A) b
2418 | b.echo_жA() // (_ *A)
2419 | b.echoжA("b") // (*A) b
2420 |
2421 | // 以下是定义在结构体指针上的方法原型,通过调用结构体类型指针上定义的函数,传入结构体的指针
2422 | (*A).echo_A(b) // (_ A)
2423 | (*A).echoA(b, "b") // (A) b
2424 | (*A).echo_жA(b) // (_ *A)
2425 | (*A).echoжA(b, "b") // (*A) b
2426 | (*A).setX(b, 1)
2427 | (*A).setY(b, 8)
2428 | println(b.x, b.y) // 0 8
2429 |
2430 | // 调用结构体空指针上的方法,以下注释掉的代码都是空指针错误
2431 | var c *A // c = nil
2432 | // c.setX(2) // ❌错误,nil pointer dereference
2433 | // c.setY(5) // ❌错误,nil pointer dereference
2434 | // println(c.x, c.y) // ❌错误,nil pointer dereference
2435 | // c.echo_A() // ❌错误,nil pointer dereference
2436 | // c.echoA() // ❌错误,nil pointer dereference
2437 | c.echo_жA() // (_ *A)
2438 | c.echoжA("c") // (*A) c
2439 |
2440 | // (*A).echo_A(c)
2441 | // (*A).echoA(c)
2442 | (*A).echo_жA(c) // (_ *A)
2443 | (*A).echoжA(c, "c") // (*A) c
2444 | // (*A).setX(c, 1)
2445 | // (*A).setY(c, 8)
2446 | // println(c.x, c.y)
2447 | }
2448 | ```
2449 |
2450 | - 结构体中组合匿名字段时,匿名字段的方法会向外传递,其规则如下:
2451 | 匿名字段为值类型时:值的方法会传递给结构体的值,指针的方法会传递给结构体的指针;
2452 | 匿名字段为指针类型时:指针的方法会传递给值和指针;
2453 | 匿名字段为接口类型时:方法会传递给值和指针;
2454 |
2455 | - Go中有匿名函数,但是没有匿名方法
2456 |
2457 | ## **并发 Concurrency, keyword:`go`**
2458 |
2459 | - 协程`goroutine`是由Go运行时环境管理的轻量级线程。
2460 | 使用关键字`go`调用一个函数/方法,启动一个新的协程goroutine
2461 |
2462 | ```go
2463 | package main
2464 |
2465 | import (
2466 | "time"
2467 | )
2468 |
2469 | func say(i int) {
2470 | println("goroutine:", i)
2471 | }
2472 |
2473 | func main() {
2474 | for i := 1; i <= 5; i++ {
2475 | go say(i)
2476 | }
2477 | say(0)
2478 | time.Sleep(5 * time.Second)
2479 | }
2480 | ```
2481 |
2482 | 主协程goroutine输出0,其他由go启动的几个子协程分别输出1~5
2483 |
2484 | > goroutine: 0
2485 | goroutine: 1
2486 | goroutine: 2
2487 | goroutine: 3
2488 | goroutine: 4
2489 | goroutine: 5
2490 |
2491 | - goroutine 在相同的地址空间中运行,因此访问共享内存必须进行同步。
2492 |
2493 | ```go
2494 | package main
2495 |
2496 | import (
2497 | "sync"
2498 | "time"
2499 | )
2500 |
2501 | var mu sync.Mutex
2502 | var i int
2503 |
2504 | func main() {
2505 | for range [5]byte{} {
2506 | go Add()
2507 | }
2508 | time.Sleep(5*time.Second)
2509 | println(i)
2510 | }
2511 |
2512 | func Add() {
2513 | // 使用互斥锁防止多个协程goroutine同时修改共享变量
2514 | // 只能限制同时访问此方法修改变量,在方法外修改则限制是无效的
2515 | mu.Lock()
2516 | defer mu.Unlock()
2517 | i++
2518 | }
2519 | ```
2520 |
2521 | 使用通道channel进行同步
2522 |
2523 | ```go
2524 | package main
2525 |
2526 | import (
2527 | "time"
2528 | )
2529 |
2530 | var i int
2531 | var ch = make(chan byte, 1)
2532 |
2533 | func main() {
2534 | for range [5]byte{} {
2535 | go Add()
2536 | }
2537 | time.Sleep(5*time.Second)
2538 | println(i)
2539 | }
2540 |
2541 | func Add() {
2542 | ch <- 0
2543 | i++
2544 | <-ch
2545 | }
2546 | ```
2547 |
2548 | - 使用channel在不同的goroutine之间通信
2549 |
2550 | ```go
2551 | // 上一个例子只是将channel用作同步开关,稍做修改即可在不同goroutine间通信
2552 | package main
2553 |
2554 | import (
2555 | "time"
2556 | )
2557 |
2558 | var i int
2559 | var ch = make(chan int, 1)
2560 |
2561 | func main() {
2562 | for range [5]byte{} {
2563 | go Add()
2564 | }
2565 | ch <- i
2566 | time.Sleep(5*time.Second)
2567 | i = <-ch
2568 | println(i)
2569 | }
2570 |
2571 | func Add() {
2572 | // 从channel中接收的值是来自其他goroutine发送的
2573 | x := <-ch
2574 | x++
2575 | ch <- x
2576 | }
2577 | ```
2578 |
2579 | ## **测试 Testing**
2580 |
2581 | - Go中自带轻量级的测试框架testing和自带的go test命令来实现单元测试和基准测试
2582 |
2583 | ### **单元测试 Unit**
2584 |
2585 | - 有如下待测试unittest包,一段简单的求和代码
2586 |
2587 | ```go
2588 | package testgo
2589 |
2590 | import "math"
2591 |
2592 | func Sum(min, max int) (sum int) {
2593 | if min < 0 || max < 0 || max > math.MaxInt32 || min > max {
2594 | return 0
2595 | }
2596 |
2597 | for ; min <= max; min++ {
2598 | sum += min
2599 | }
2600 | return
2601 | }
2602 | ```
2603 |
2604 | - 测试源文件名必须是`_test.go`结尾的,go test的时候才会执行到相应的代码
2605 | 必须import testing包
2606 | 所有的测试用例函数必须以`Test`开头
2607 | 测试用例按照源码中编写的顺序依次执行
2608 | 测试函数TestXxx()的参数是`*testing.T`,可以使用该类型来记录错误或者是测试状态
2609 | 测试格式:`func TestXxx (t *testing.T)`,Xxx部分可以为任意的字母数字的组合,首字母不能是小写字母[a-z],例如Testsum是错误的函数名。
2610 | 函数中通过调用*testing.T的Error,Errorf,FailNow,Fatal,FatalIf方法标注测试不通过,调用Log方法用来记录测试的信息。
2611 |
2612 | ```go
2613 | package testgo
2614 |
2615 | import "testing"
2616 |
2617 | func TestSum(t *testing.T) {
2618 | s := Sum(1, 0)
2619 | t.Log("Sum 1 to 0:", s)
2620 | if 0 != s {
2621 | t.Error("not equal.")
2622 | }
2623 | s = Sum(1, 10)
2624 | t.Log("Sum 1 to 10:", s)
2625 | if 55 != s {
2626 | t.Error("not equal.")
2627 | }
2628 | }
2629 | ```
2630 |
2631 | 在当前包中执行测试:`go test -v`
2632 |
2633 | > === RUN TestSum
2634 | --- PASS: TestSum (0.00s)
2635 | t0_test.go:7: Sum 1 to 0: 0
2636 | t0_test.go:12: Sum 1 to 10: 55
2637 | PASS
2638 | ok /home/yougg/code/unittest 0.004s
2639 |
2640 | ### **基准测试 Benchmark**
2641 |
2642 | - 基准测试 Benchmark用来检测函数/方法的性能
2643 | 基准测试用例函数必须以`Benchmark`开头
2644 | go test默认不会执行基准测试的函数,需要加上参数-test.bench
2645 | 语法:-test.bench="test_name_regex",例如go test -test.bench=".*"表示测试全部的基准测试函数
2646 | 在基准测试用例中,在循环体内使用testing.B.N,使测试可以正常的运行
2647 |
2648 | ```go
2649 | package testgo
2650 |
2651 | import "testing"
2652 |
2653 | func BenchmarkSum(b *testing.B) {
2654 | b.Logf("Sum 1 to %d: %d\n", b.N, Sum(1, b.N))
2655 | }
2656 | ```
2657 |
2658 | 在当前包中执行测试:`go test -v -bench .`
2659 |
2660 | > BenchmarkSum 2000000000 0.91 ns/op
2661 | --- BENCH: BenchmarkSum
2662 | t0_test.go:19: Sum 1 to 1: 1
2663 | t0_test.go:19: Sum 1 to 100: 5050
2664 | t0_test.go:19: Sum 1 to 10000: 50005000
2665 | t0_test.go:19: Sum 1 to 1000000: 500000500000
2666 | t0_test.go:19: Sum 1 to 100000000: 5000000050000000
2667 | t0_test.go:19: Sum 1 to 2000000000: 2000000001000000000
2668 | ok /home/yougg/code/benchmark 1.922s
2669 |
2670 | ### **模糊测试 Fuzzing**
2671 |
2672 | - 模糊测试针对测试运行输入随机数据,尝试找出漏洞或导致崩溃的输入
2673 | 可以通过模糊测试发现的一些漏洞示例包括 SQL 注入、缓冲区溢出、拒绝服务和跨站点脚本攻击。
2674 |
2675 | ```go
2676 | // 待测试函数
2677 | func Reverse(s string) string {
2678 | b := []byte(s)
2679 | for i, j := 0, len(b)-1; i < len(b)/2; i, j = i+1, j-1 {
2680 | b[i], b[j] = b[j], b[i]
2681 | }
2682 | return string(b)
2683 | }
2684 | ```
2685 |
2686 | 模糊测试用例函数以`Fuzz`开头
2687 |
2688 | ```go
2689 | func FuzzReverse(f *testing.F) {
2690 | testcases := []string{"Hello, world", " ", "!12345"}
2691 | for _, tc := range testcases {f.Add(tc) // Use f.Add to provide a seed corpus
2692 | }
2693 | f.Fuzz(func(t *testing.T, orig string) {
2694 | rev := Reverse(orig)
2695 | doubleRev := Reverse(rev)
2696 | if orig != doubleRev {
2697 | t.Errorf("Before: %q, after: %q", orig, doubleRev)
2698 | }
2699 | if utf8.ValidString(orig) && !utf8.ValidString(rev) {
2700 | t.Errorf("Reverse produced invalid UTF-8 string %q", rev)
2701 | }
2702 | })
2703 | }
2704 | ```
2705 |
2706 | 在当前包中执行测试:`go test -fuzz FuzzReverse`
2707 |
2708 | > fuzz: elapsed: 0s, gathering baseline coverage: 0/11 completed
2709 | failure while testing seed corpus entry: FuzzReverse/91f92b2e5d60254ba0d9f6ed565497fc550f81fe2c93c55c9a00034ffc3bceaf
2710 | fuzz: elapsed: 0s, gathering baseline coverage: 3/11 completed
2711 | --- FAIL: FuzzReverse (0.03s)
2712 | --- FAIL: FuzzReverse (0.00s)
2713 | hi_test.go:59: Reverse produced invalid UTF-8 string "\x81\xc7"
2714 | >
2715 | > FAIL
2716 | exit status 1
2717 | FAIL /home/yougg/code/fuzz 0.176s
2718 |
2719 | ## **泛型 Generics** `Go1.18+`
2720 |
2721 | ### **类型约束 type constraint**
2722 |
2723 | 
2724 |
2725 | - 定义约束指定类型`T`的`类型约束`接口
2726 |
2727 | ```go
2728 | type I10 interface {
2729 | int
2730 | }
2731 |
2732 | type I11 interface {
2733 | string
2734 | }
2735 | ```
2736 |
2737 | ```go
2738 | type S struct {
2739 | b bool
2740 | e error
2741 | }
2742 |
2743 | type I12 interface {
2744 | S
2745 | }
2746 | ```
2747 |
2748 | - 定义约束近似类型`~T`的`类型约束`接口
2749 |
2750 | ```go
2751 | type I20 interface {
2752 | ~int
2753 | }
2754 |
2755 | type I21 interface {
2756 | ~string
2757 | }
2758 | ```
2759 |
2760 | 约束近似类型的限制:
2761 |
2762 | - 近似类型`~T`必须是底层类型自身, 不能是基于底层类型自定义的新类型
2763 | 在[自定义类型](#自定义类型)小节中所有自定义的`A~Z`类型都被限制
2764 |
2765 | ```go
2766 | type I22 interface {
2767 | ~A // ❌错误: A的底层类型是 int
2768 | ~B // ❌错误: B的底层类型是 int8
2769 | ~C // ❌错误: C的底层类型是 int16
2770 | ~D // ❌错误: D的底层类型是 rune
2771 | ~E // ❌错误: E的底层类型是 int32
2772 | ~F // ❌错误: F的底层类型是 int64
2773 | ~G // ❌错误: G的底层类型是 uint
2774 | ~H // ❌错误: H的底层类型是 byte
2775 | ~I // ❌错误: I的底层类型是 uint16
2776 | ~J // ❌错误: J的底层类型是 uint32
2777 | ~K // ❌错误: K的底层类型是 uint64
2778 | ~L // ❌错误: L的底层类型是 float32
2779 | ~M // ❌错误: M的底层类型是 float64
2780 | ~N // ❌错误: N的底层类型是 complex64
2781 | ~O // ❌错误: O的底层类型是 complex128
2782 | ~P // ❌错误: P的底层类型是 uintptr
2783 | ~Q // ❌错误: Q的底层类型是 bool
2784 | ~R // ❌错误: R的底层类型是 string
2785 | ~S // ❌错误: S的底层类型是 [3]uint8
2786 | ~T // ❌错误: T的底层类型是 []complex128
2787 | ~U // ❌错误: U的底层类型是 map[string]uintptr
2788 | ~V // ❌错误: V的底层类型是 func(i int) (b bool)
2789 | ~W // ❌错误: W的底层类型是 struct {a, b int}
2790 | ~X // ❌错误: X的底层类型是 chan int
2791 | ~Y // ❌错误: Y的底层类型是 any
2792 | ~Z // ❌错误: Z的底层类型是 int
2793 | }
2794 |
2795 | // 正确的近似类型
2796 | type I23 interface {
2797 | ~int
2798 | ~int8
2799 | ~int16
2800 | ~rune
2801 | ~int32
2802 | ~int64
2803 | ~uint
2804 | ~byte
2805 | ~uint16
2806 | ~uint32
2807 | ~uint64
2808 | ~float32
2809 | ~float64
2810 | ~complex64
2811 | ~complex128
2812 | ~uintptr
2813 | ~bool
2814 | ~string
2815 | ~[3]uint8
2816 | ~[]complex128
2817 | ~map[string]uintptr
2818 | ~func(i int) (b bool)
2819 | ~struct {a, b int}
2820 | ~chan int
2821 | }
2822 | ```
2823 |
2824 | - 近似类型`~T`不能是接口类型
2825 |
2826 | ```go
2827 | type I24 interface {
2828 | ~error // ❌错误: 不能是接口类型
2829 | }
2830 | ```
2831 |
2832 | - 定义约束联合类型`A|B|C|~D`的`类型约束`接口
2833 |
2834 | ```go
2835 | type I30 interface {
2836 | int
2837 | string
2838 | }
2839 |
2840 | type I31 interface {
2841 | ~int
2842 | ~string
2843 | }
2844 |
2845 | type I32 interface {
2846 | int
2847 | string
2848 | ~int
2849 | ~string
2850 | }
2851 |
2852 | type Signed interface {
2853 | ~int | ~int8 | ~int16 | ~int32 | ~int64
2854 | }
2855 |
2856 | type Unsigned interface {
2857 | ~uint | ~uint8 | ~uint16 | ~uint32 | ~uint64 | ~uintptr
2858 | }
2859 |
2860 | type Integer interface {
2861 | Signed | Unsigned
2862 | }
2863 |
2864 | type Number interface {
2865 | Integer
2866 | String() string
2867 | }
2868 | ```
2869 |
2870 | - `类型约束`接口的限制
2871 |
2872 | - 命名或匿名的`类型约束`接口只能用于`类型参数`声明
2873 |
2874 | - 不能用于全局/局部变量、函数/方法形参以及结构体字段的声明
2875 |
2876 | ```go
2877 | var i0 interface{ int } // ❌错误,不能做为全局变量的类型
2878 |
2879 | func Fn0() {
2880 | var i1 constraints.Integer // ❌错误,不能做为局部变量的类型
2881 | }
2882 |
2883 | func Fn1(i2 interface{ ~int }) { } // ❌错误,不能做为函数参数的类型
2884 |
2885 | var i3 struct{ F0 ~int } // ❌错误,不能做为结构体字段的类型
2886 | var i4 struct{ F1 constraints.Integer } // ❌错误
2887 | ```
2888 |
2889 | - `类型约束`接口的联合类型不能存在交集
2890 |
2891 | ```go
2892 | type I0 interface {
2893 | int | ~int // ❌错误,int和~int类型的交集是int
2894 | }
2895 | ```
2896 |
2897 | ### **类型参数 type parameters**
2898 |
2899 | 
2900 |
2901 | - `类型参数`声明在函数名与函数参数左括号之间, 为包含在`[]`中的一个或多个参数和约束类型
2902 |
2903 | ```go
2904 | // 为函数声明类型参数T, 其类型为any
2905 | func ZeroValue[T any]() {
2906 | var x T
2907 | fmt.Printf("zero value of %T type: %v\n", x, x)
2908 | }
2909 |
2910 | func main() {
2911 | ZeroValue[bool]() // zero value of bool type: false
2912 | ZeroValue[complex64]() // zero value of complex64 type: (0+0i)
2913 | ZeroValue[[3]int]() // zero value of [3]int type: [0 0 0]
2914 | ZeroValue[map[string]int]() // zero value of map[string]int type: map[]
2915 | ZeroValue[struct {
2916 | b bool
2917 | e error
2918 | }]() // zero value of struct { b bool; e error } type: {false }
2919 | }
2920 | ```
2921 |
2922 | `类型参数`作为函数输入参数或返回值的类型
2923 |
2924 | ```go
2925 | func Fn0[T, U any](t T, u U) {
2926 | fmt.Println(t, u)
2927 | }
2928 |
2929 | func Fn1[T constraints.Integer]() (t T) {
2930 | return T(rand.Int()) // 使用类型参数强制转换类型
2931 | }
2932 |
2933 | func Fn2[K comparable, V any](m map[K]V) {
2934 | fmt.Println(m)
2935 | }
2936 |
2937 | func main() {
2938 | Fn0[int, int](123, 456) // 123 456
2939 | Fn0[string, string]("hello", "world") // hello
2940 | fmt.Println(Fn1[int64]()) // 5577006791947779410
2941 | Fn2[int, int](map[int]int{1: 2, 3: 4}) // map[1:2 3:4]
2942 |
2943 | // 函数调用省略类型参数实参[...], Go自动推导其类型
2944 | Fn0(789, "xyz") // 789 xyz
2945 | Fn2(map[string]bool{"x": true, "y": false}) // map[x:true y:false]
2946 |
2947 | // 无法推导类型的场景不能省略类型参数实参
2948 | fmt.Println(Fn1[uint64]()) // 8674665223082153551
2949 | }
2950 | ```
2951 |
2952 | - `类型参数`声明在类型名右边, 为包含在`[]`中的一个或多个参数和约束类型
2953 |
2954 | ```go
2955 | type S[T any] struct {
2956 | Field T
2957 | }
2958 |
2959 | func (s *S[T])Set(t T) {
2960 | s.Field = t
2961 | }
2962 |
2963 | func (s *S[T]) Get() (t T) {
2964 | return s.Field
2965 | }
2966 |
2967 | func main() {
2968 | var s0 = new(S[int])
2969 | // s0.Field = 123
2970 | s0.Set(456)
2971 | fmt.Printf("%#v\n", s0)
2972 |
2973 | s1 := S[string]{
2974 | Field: "hello",
2975 | }
2976 | fmt.Printf("%#v\n", s1)
2977 | fmt.Printf("%#v\n", s1.Get())
2978 | }
2979 | ```
2980 |
2981 | - `类型参数`的类型支持指定类型、近似类型、联合类型、匿名和命名的`类型约束`接口
2982 |
2983 | ```go
2984 | func Fn10[T int, U uint]() { /* ... */ }
2985 | func Fn11[T ~string]() { /* ... */ }
2986 | func Fn12[T ~int | string]() { /* ... */ }
2987 | func Fn13[T interface{ int }]() { /* ... */ }
2988 | func Fn14[T constraints.Integer]() { /* ... */ }
2989 | ```
2990 |
2991 | - 基于`类型参数`定义`类型约束`接口
2992 |
2993 | ```go
2994 | type Slice[T any] interface {
2995 | ~[]T
2996 | }
2997 |
2998 | type Map[K comparable, V any] interface {
2999 | ~map[K]V
3000 | }
3001 |
3002 | type Chan[T any] interface {
3003 | ~chan T
3004 | }
3005 | ```
3006 |
3007 | - 基于`类型参数`定义泛型类型别名 `Go1.24+`
3008 |
3009 | ```go
3010 | type A[T comparable] int
3011 | type B[U int|byte|string] = A[U]
3012 | type C B[int]
3013 | ```
3014 |
3015 | - `类型参数`的限制
3016 |
3017 | - 不能将`类型参数`作为直接的约束类型
3018 |
3019 | ```go
3020 | func Fn0[T any, U T]() { } // ❌错误,不能将类型参数T做为类型参数U的约束类型
3021 | func Fn1[T any, U []T]() { } // 正确,约束的类型是[]T
3022 | func Fn2[T comparable, U any, V map[T]U]() { } // 正确,约束的类型是map[T]U
3023 | ```
3024 |
3025 | - 不能联合或嵌入`类型参数`和`comparable`作为约束的类型
3026 |
3027 | ```go
3028 | func Fn0[T any, U int | T]() { } // ❌错误
3029 | func Fn1[T any, U interface{ T }]() { } // ❌错误
3030 | func Fn2[T any, U interface{ T | string }]() { } // ❌错误
3031 | func Fn3[T comparable | int]() { } // ❌错误
3032 | func Fn4[T interface{ comparable }]() { } // ❌错误
3033 | ```
3034 |
3035 | - 联合的约束类型不能存在交集
3036 |
3037 | ```go
3038 | func Fn0[T int | ~int]() { } // ❌错误
3039 | func Fn1[T interface{ int | ~int }]() { } // ❌错误
3040 |
3041 | type Str string
3042 | func Fn2[T string | Str]() { } // 正确,Str和string是两个不同类型没有交集
3043 | func Fn3[T string | ~Str]() { } // ❌错误,~Str是string的近似类型存在交集string
3044 |
3045 | func Fn4[T byte | uint8]() { } // ❌错误,byte和uint8是相同的类型
3046 | ```
3047 |
3048 | - 联合的约束类型不能使用含有方法的接口类型
3049 |
3050 | ```go
3051 | func Fn0[T error | int]() { } // ❌错误,error接口含有方法
3052 | func Fn1[T interface{ string | io.Reader }]() { } // ❌错误
3053 | func Fn2[T interface{ io.Reader | io.Writer }]() { } // ❌错误
3054 | ```
3055 |
--------------------------------------------------------------------------------