Go语言基地

Go编程语言规范

语言版本 go1.26 (2026年1月12日)

介绍

Go是一种通用语言,设计时考虑了系统编程。它具有强类型、垃圾回收和对并发编程的显式支持。程序由构成,其属性允许高效管理依赖关系。

语法紧凑且易于解析,便于集成开发环境等自动工具进行分析。

符号

语法使用扩展巴科斯范式(EBNF)的变体指定:

语法        = { 产生式 } .
产生式      = 产生式名称 "=" [ 表达式 ] "." .
表达式      = 项 { "|" 项 } .
项          = 因子 { 因子 } .
因子        = 产生式名称 | 标记 [ "…" 标记 ] | 组 | 选项 | 重复 .
组          = "(" 表达式 ")" .
选项        = "[" 表达式 "]" .
重复        = "{" 表达式 "}" .

产生式是由项和以下运算符构成的表达式,按优先级递增顺序:

|   选择
()  分组
[]  可选(0或1次)
{}  重复(0到n次)

小写产生式名称用于标识词法(终结)标记。非终结符使用驼峰命名法。词法标记用双引号""或反引号``括起来。

形式a … b表示从ab的字符集合作为选择。水平省略号也用于规范的其他地方,非正式地表示各种枚举或代码片段,这些未进一步指定。字符(与三个字符...不同)不是Go语言的标记。

形式为[[Go 1.xx](/cn/docs/spec#Language_versions)]的链接表示描述的语言特性(或其某些方面)随语言版本1.xx更改或添加,因此至少需要该语言版本才能构建。详情请参阅附录中的链接部分

源代码表示

源代码是UTF-8编码的Unicode文本。文本未规范化,因此单个重音码点是distinct的,不同于由重音和字母组合构造的相同字符;这些被视为两个码点。为简单起见,本文档将使用非限定术语字符来指代源代码中的Unicode码点。

每个码点都是distinct的;例如,大写和小写字母是不同的字符。

实现限制:为与其他工具兼容,编译器可能不允许源代码中的NUL字符(U+0000)。

实现限制:为与其他工具兼容,编译器可能忽略源代码中第一个Unicode码点的UTF-8编码字节顺序标记(U+FEFF)。字节顺序标记可能不允许出现在源代码的其他任何地方。

字符

以下术语用于表示特定的Unicode字符类别:

换行符        = /* Unicode码点U+000A */ .
unicode_char   = /* 除换行符外的任意Unicode码点 */ .
unicode_letter = /* 分类为"字母"的Unicode码点 */ .
unicode_digit  = /* 分类为"数字,十进制数字"的Unicode码点 */ .

Unicode标准8.0第4.5节"通用类别"中定义了一组字符类别。Go将所有属于任何字母类别Lu, Ll, Lt, Lm或Lo的字符视为Unicode字母,将属于数字类别Nd的字符视为Unicode数字。

字母和数字

下划线字符_(U+005F)被视为小写字母。

letter        = unicode_letter | "_" .
decimal_digit = "0" … "9" .
binary_digit  = "0" | "1" .
octal_digit   = "0" … "7" .
hex_digit     = "0" … "9" | "A" … "F" | "a" … "f" .

词法元素

注释作为程序文档。有两种形式:

  1. 行注释以字符序列//开始,在行尾停止。
  2. 通用注释以字符序列/*开始,在第一个后续字符序列*/停止。

注释不能开始于rune字面量string字面量内部,或注释内部。不包含新行的通用注释表现为空格。任何其他注释表现为换行符。

标记

标记构成Go语言的词汇。有四类:标识符关键字运算符和标点符号以及字面量。由空格(U+0020)、水平制表符(U+0009)、回车(U+000D)和换行符(U+000A)形成的空白被忽略,除非它分隔本应合并成单个标记的标记。此外,换行符或文件结束可能触发分号的插入。在将输入分解为标记时,下一个标记是形成有效标记的最长字符序列。

分号

形式语法在许多产生式中使用分号";"作为终止符。Go程序可以使用以下两个规则省略大多数这些分号:

  1. 当输入被分解为标记时,如果行的最终标记是
  2. 为允许复杂语句占用单行,分号可在闭合")""}"前省略。

为反映惯用法,本文档中的代码示例使用这些规则省略分号。

标识符

标识符命名程序实体,如变量和类型。标识符是一个或多个字母和数字的序列。标识符中的第一个字符必须是字母。

identifier = letter { letter | unicode_digit } .
a
_x9
ThisVariableIsExported
αβ

一些标识符是预声明的

关键字

以下关键字是保留的,不能用作标识符。

break        default      func         interface    select
case         defer        go           map          struct
chan         else         goto         package      switch
const        fallthrough  if           range        type
continue     for          import       return       var

运算符和标点符号

以下字符序列表示运算符(包括赋值运算符)和标点符号[Go 1.18]:

+    &     +=    &=     &&    ==    !=    (    )
-    |     -=    |=     ||    <     <=    [    ]
*    ^     *=    ^=     <-    >     >=    {    }
/    <<    /=    <<=    ++    =     :=    ,    ;
%    >>    %=    >>=    --    !     ...   .    :
     &^          &^=          ~

整数字面量

整数字面量是表示整数常量的数字序列。可选前缀设置非十进制基数:0b0B表示二进制,00o0O表示八进制,0x0X表示十六进制[Go 1.13]。单个0被视为十进制零。在十六进制字面量中,字母afAF表示值10到15。

为便于阅读,下划线字符_可出现在基数前缀后或连续数字之间;此类下划线不改变字面量的值。

int_lit        = decimal_lit | binary_lit | octal_lit | hex_lit .
decimal_lit    = "0" | ( "1" … "9" ) [ [ "_" ] decimal_digits ] .
binary_lit     = "0" ( "b" | "B" ) [ "_" ] binary_digits .
octal_lit      = "0" [ "o" | "O" ] [ "_" ] octal_digits .
hex_lit        = "0" ( "x" | "X" ) [ "_" ] hex_digits .

decimal_digits = decimal_digit { [ "_" ] decimal_digit } .
binary_digits  = binary_digit { [ "_" ] binary_digit } .
octal_digits   = octal_digit { [ "_" ] octal_digit } .
hex_digits     = hex_digit { [ "_" ] hex_digit } .
42
4_2
0600
0_600
0o600
0O600       // 第二个字符是大写字母'O'
0xBadFace
0xBad_Face
0x_67_7a_2f_cc_40_c6
170141183460469231731687303715884105727
170_141183_460469_231731_687303_715884_105727

_42         // 标识符,不是整数字面量
42_         // 无效:_必须分隔连续数字
4__2        // 无效:一次只能有一个_
0_xBadFace  // 无效:_必须分隔连续数字

浮点字面量

浮点字面量是浮点常量的十进制或十六进制表示。

十进制浮点字面量由整数部分(十进制数字)、小数点、小数部分(十进制数字)和指数部分(eE后跟可选符号和十进制数字)组成。整数部分或小数部分之一可省略;小数点或指数部分之一可省略。指数值exp将尾数(整数和小数部分)按10exp缩放。

十六进制浮点字面量由0x0X前缀、整数部分(十六进制数字)、基数点、小数部分(十六进制数字)和指数部分(pP后跟可选符号和十进制数字)组成。整数部分或小数部分之一可省略;基数点也可省略,但指数部分是必需的。(此语法符合IEEE 754-2008 §5.12.3中给出的语法。)指数值exp将尾数(整数和小数部分)按2exp缩放[Go 1.13]。

为便于阅读,下划线字符_可出现在基数前缀后或连续数字之间;此类下划线不改变字面量的值。

float_lit         = decimal_float_lit | hex_float_lit .

decimal_float_lit = decimal_digits "." [ decimal_digits ] [ decimal_exponent ] |
                    decimal_digits decimal_exponent |
                    "." decimal_digits [ decimal_exponent ] .
decimal_exponent  = ( "e" | "E" ) [ "+" | "-" ] decimal_digits .

hex_float_lit     = "0" ( "x" | "X" ) hex_mantissa hex_exponent .
hex_mantissa      = [ "_" ] hex_digits "." [ hex_digits ] |
                    [ "_" ] hex_digits |
                    "." hex_digits .
hex_exponent      = ( "p" | "P" ) [ "+" | "-" ] decimal_digits .
0.
72.40
072.40       // == 72.40
2.71828
1.e+0
6.67428e-11
1E6
.25
.12345E+5
1_5.         // == 15.0
0.15e+0_2    // == 15.0

0x1p-2       // == 0.25
0x2.p10      // == 2048.0
0x1.Fp+0     // == 1.9375
0X.8p-0      // == 0.5
0X_1FFFP-16  // == 0.1249847412109375
0x15e-2      // == 0x15e - 2 (整数减法)

0x.p1        // 无效:尾数没有数字
1p-2         // 无效:p指数需要十六进制尾数
0x1.5e-2     // 无效:十六进制尾数需要p指数
1_.5         // 无效:_必须分隔连续数字
1._5         // 无效:_必须分隔连续数字
1.5_e1       // 无效:_必须分隔连续数字
1.5e_1       // 无效:_必须分隔连续数字
1.5e1_       // 无效:_必须分隔连续数字

虚数字面量

虚数字面量表示复数常量的虚部。它由整数浮点字面量后跟小写字母i组成。虚数字面量的值是相应整数或浮点字面量的值乘以虚数单位_i_[Go 1.13]

imaginary_lit = (decimal_digits | int_lit | float_lit) "i" .

为向后兼容,完全由十进制数字(可能包含下划线)组成的虚数字面量的整数部分被视为十进制整数,即使它以前导0开头。

0i
0123i         // == 123i 为向后兼容
0o123i        // == 0o123 * 1i == 83i
0xabci        // == 0xabc * 1i == 2748i
0.i
2.71828i
1.e+0i
6.67428e-11i
1E6i
.25i
.12345E+5i
0x1p-2i       // == 0x1p-2 * 1i == 0.25i

Rune字面量

Rune字面量表示rune常量,标识Unicode码点的整数值。Rune字面量表示为单引号内的单个或多个字符,如'x''\n'。在引号内,除换行符和未转义的单引号外,任何字符都可以出现。单引号字符表示字符本身的Unicode值,而以反斜杠开始的多字符序列以各种格式编码值。

最简单的形式表示引号内的单个字符;由于Go源代码是UTF-8编码的Unicode字符,多个UTF-8编码字节可能表示单个整数值。例如,字面量'a'包含表示字面量a(Unicode U+0061, 值0x61)的单个字节,而'ä'包含两个字节(0xc3 0xa4)表示a-分音符字面量(U+00E4, 值0xe4)。

几种反斜杠转义允许将任意值编码为ASCII文本。有四种方式将整数值表示为数值常量:\x后跟恰好两个十六进制数字;\u后跟恰好四个十六进制数字;\U后跟恰好八个十六进制数字;以及普通反斜杠\后跟恰好三个八进制数字。每种情况下,字面量的值是相应基数中数字表示的值。

尽管这些表示都导致整数,但它们有不同的有效范围。八进制转义必须表示0到255(含)之间的值。十六进制转义通过构造满足此条件。转义\u\U表示Unicode码点,因此其中一些值是非法的,特别是那些超过0x10FFFF的值和代理半部分。

在反斜杠后,某些单字符转义表示特殊值:

\a   U+0007 警报或响铃
\b   U+0008 退格
\f   U+000C 换页
\n   U+000A 换行或新行
\r   U+000D 回车
\t   U+0009 水平制表符
\v   U+000B 垂直制表符
\\   U+005C 反斜杠
\'   U+0027 单引号 (仅在rune字面量中有效的转义)
\"   U+0022 双引号 (仅在字符串字面量中有效的转义)

在rune字面量中反斜杠后的未识别字符是非法的。

rune_lit         = "'" ( unicode_value | byte_value ) "'" .
unicode_value    = unicode_char | little_u_value | big_u_value | escaped_char .
byte_value       = octal_byte_value | hex_byte_value .
octal_byte_value = `\` octal_digit octal_digit octal_digit .
hex_byte_value   = `\` "x" hex_digit hex_digit .
little_u_value   = `\` "u" hex_digit hex_digit hex_digit hex_digit .
big_u_value      = `\` "U" hex_digit hex_digit hex_digit hex_digit
                           hex_digit hex_digit hex_digit hex_digit .
escaped_char     = `\` ( "a" | "b" | "f" | "n" | "r" | "t" | "v" | `\` | "'" | `"` ) .
'a'
'ä'
'本'
'\t'
'\000'
'\007'
'\377'
'\x07'
'\xff'
'\u12e4'
'\U00101234'
'\''         // 包含单引号字符的rune字面量
'aa'         // 非法:字符太多
'\k'         // 非法:k在反斜杠后未被识别
'\xa'        // 非法:十六进制数字太少
'\0'         // 非法:八进制数字太少
'\400'       // 非法:八进制值超过255
'\uDFFF'     // 非法:代理半部分
'\U00110000' // 非法:无效Unicode码点

字符串字面量

字符串字面量表示通过连接字符序列获得的字符串常量。有两种形式:原始字符串字面量和解释字符串字面量。

原始字符串字面量是反引号之间的字符序列,如`foo`。在引号内,除反引号外,任何字符都可以出现。原始字符串字面量的值是引号之间未解释的(隐式UTF-8编码的)字符组成的字符串;特别是,反斜杠没有特殊含义,字符串可以包含换行符。原始字符串值中的回车字符('\r')被丢弃。

解释字符串字面量是双引号之间的字符序列,如"bar"。在引号内,除换行符和未转义的双引号外,任何字符都可以出现。引号之间的文本形成字面量的值,反斜杠转义按rune字面量中的方式解释(除了\'是非法的且\"是合法的),具有相同的限制。三位八进制(\nnn)和两位十六进制(\xnn)转义表示结果字符串的单个字节;所有其他转义表示单个字符的(可能多字节的)UTF-8编码。因此,在字符串字面量中,\377\xFF表示值0xFF=255的单个字节,而ÿ\u00FF\U000000FF\xc3\xbf表示字符U+00FF的UTF-8编码的两个字节0xc3 0xbf

string_lit             = raw_string_lit | interpreted_string_lit .
raw_string_lit         = "`" { unicode_char | newline } "`" .
interpreted_string_lit = `"` { unicode_value | byte_value } `"` .
`abc`                // 与"abc"相同
`\n
\n`                  // 与"\\n\n\\n"相同
"\n"
"\""                 // 与`"`相同
"Hello, world!\n"
"日本語"
"\u65e5本\U00008a9e"
"\xff\u00FF"
"\uD800"             // 非法:代理半部分
"\U00110000"         // 非法:无效Unicode码点

这些示例都表示相同的字符串:

"日本語"                                 // UTF-8输入文本
`日本語`                                 // UTF-8输入文本作为原始字面量
"\u65e5\u672c\u8a9e"                    // 显式Unicode码点
"\U000065e5\U0000672c\U00008a9e"        // 显式Unicode码点
"\xe6\x97\xa5\xe6\x9c\xac\xe8\xaa\x9e"  // 显式UTF-8字节

如果源代码将字符表示为两个码点,如涉及重音和字母的组合形式,如果放在rune字面量中(它不是单个码点)会出错,如果放在字符串字面量中会显示为两个码点。

常量

布尔常量rune常量整数常量浮点常量复数常量字符串常量。Rune、整数、浮点和复数常量统称为数值常量

常量值由rune整数浮点虚数string字面量、表示常量的标识符、常量表达式、结果为常量的转换或某些内置函数(如应用于常量参数的minmax、应用于某些值unsafe.Sizeof、应用于某些表达式caplen、应用于复数常量的realimag以及应用于数值常量的complex)的结果值表示。布尔真值由预声明常量truefalse表示。预声明标识符iota表示整数常量。

一般来说,复数常量是常量表达式的一种形式,在该节中讨论。

数值常量表示任意精度的精确值,不会溢出。因此,没有常量表示IEEE 754负零、无穷大和非数值。

常量可以是类型化未类型化。字面量常量、truefalseiota以及仅包含未类型化常量操作数的某些常量表达式是未类型化的。

常量可以通过常量声明转换显式给定类型,或在变量声明赋值语句中隐式给定类型,或作为表达式中的操作数。如果常量值不能表示为相应类型的值,则出错。如果类型是类型参数,常量将转换为类型参数的非常量值。

未类型化常量有默认类型,这是在需要类型化值的上下文中常量隐式转换成的类型,例如,在i := 0这样的短变量声明中,没有显式类型。未类型化常量的默认类型分别是boolruneintfloat64complex128string,取决于它是布尔、rune、整数、浮点、复数还是字符串常量。

实现限制:尽管数值常量在语言中具有任意精度,但编译器可能使用有限精度的内部表示来实现它们。也就是说,每个实现必须:

  • 用至少256位表示整数常量。
  • 用至少256位的尾数和至少16位的有符号二进制指数表示浮点常量(包括复数常量的部分)。
  • 如果无法精确表示整数常量,则给出错误。
  • 如果由于溢出而无法表示浮点或复数常量,则给出错误。
  • 如果由于精度限制而无法表示浮点或复数常量,则四舍五入到最接近的可表示常量。

这些要求既适用于字面量常量,也适用于常量表达式的求值结果。

变量

变量是保存的存储位置。允许值的集合由变量的*类型*决定。

变量声明或函数参数和结果的函数声明函数字面量的签名保留命名变量的存储。调用内置函数new或取复合字面量的地址在运行时分配变量的存储。这样的匿名变量通过(可能是隐式的)指针间接引用

数组切片结构体类型的结构化变量有可以单独寻址的元素和字段。每个这样的元素都像变量一样。

变量的静态类型(或简称类型)是其声明中给出的类型、new调用或复合字面量中提供的类型,或结构化变量的元素的类型。接口类型变量还有不同的动态类型,它是运行时分配给变量的值的(非接口)类型(除非值是预声明标识符nil,它没有类型)。动态类型可能在执行期间变化,但存储在接口变量中的值总是可分配给变量的静态类型。

var x interface{}  // x为nil,静态类型为interface{}
var v *T           // v值为nil,静态类型为*T
x = 42             // x值为42,动态类型为int
x = v              // x值为(*T)(nil),动态类型为*T

变量的值通过表达式中引用变量来检索;它是分配给变量的最新值。如果变量尚未分配值,则其值为其类型的零值

类型

类型确定一组值以及特定于这些值的操作和方法。类型可以由类型名表示(如果有),如果是泛型类型,则必须后跟类型参数。类型也可以使用类型字面量指定,它从现有类型组合类型。

Type     = TypeName [ TypeArgs ] | TypeLit | "(" Type ")" .
TypeName = identifier | QualifiedIdent .
TypeArgs = "[" TypeList [ "," ] "]" .
TypeList = Type { "," Type } .
TypeLit  = ArrayType | StructType | PointerType | FunctionType | InterfaceType |
           SliceType | MapType | ChannelType .

语言预声明某些类型名。其他类型通过类型声明类型参数列表引入。复合类型—数组、结构体、指针、函数、接口、切片、映射和通道类型—可以使用类型字面量构造。

预声明类型、定义类型和类型参数称为命名类型。如果别名声明中给出的类型是命名类型,则别名表示命名类型。

布尔类型

布尔类型表示由预声明常量truefalse表示的布尔真值集合。预声明布尔类型是bool;它是一种定义类型

数值类型

整数浮点复数类型分别表示整数、浮点或复数值的集合。它们统称为数值类型。预声明与架构无关的数值类型有:

uint8       所有无符号8位整数集合 (0 to 255)
uint16      所有无符号16位整数集合 (0 to 65535)
uint32      所有无符号32位整数集合 (0 to 4294967295)
uint64      所有无符号64位整数集合 (0 to 18446744073709551615)

int8        所有带符号8位整数集合 (-128 to 127)
int16       所有带符号16位整数集合 (-32768 to 32767)
int32       所有带符号32位整数集合 (-2147483648 to 2147483647)
int64       所有带符号64位整数集合 (-9223372036854775808 to 9223372036854775807)

float32     所有IEEE 754 32位浮点数字集合
float64     所有IEEE 754 64位浮点数字集合

complex64   所有实部和虚部为float32的复数集合
complex128  所有实部和虚部为float64的复数集合

byte        uint8的别名
rune        int32的别名

n位整数的值是n位宽,并使用二进制补码算术表示。

还有一组预声明具有实现特定大小的整数类型:

uint     32或64位
int      与uint相同大小
uintptr  足够大的无符号整数,用于存储指针值的未解释位

为避免可移植性问题,所有数值类型都是定义类型,因此除了byte(是uint8别名)和rune(是int32的别名)外都是distinct的。当不同数值类型在表达式或赋值中混合时,需要显式转换。例如,即使int32int在特定架构上大小相同,它们也不是相同类型。

字符串类型

字符串类型表示字符串值集合。字符串值是(可能为空的)字节序列。字节数称为字符串的长度,永不为负。字符串是不可变的:一旦创建,就无法更改字符串的内容。预声明字符串类型是string;它是一种定义类型

字符串s的长度可以使用内置函数len发现。如果字符串是常量,则长度是编译时常量。字符串的字节可以通过整数索引0到len(s)-1访问。取这种元素的地址是非法的;如果s[i]是字符串的第i个字节,&s[i]是无效的。

数组类型

数组是称为元素类型的单一类型的编号元素序列。元素数称为数组的长度,永不为负。

ArrayType   = "[" ArrayLength "]" ElementType .
ArrayLength = Expression .
ElementType = Type .

长度是数组类型的一部分;它必须求值为非负常量可表示int类型的值。数组a的长度可以使用内置函数len发现。元素可以通过整数索引0到len(a)-1寻址。数组类型始终是一维的,但可以组合形成多维类型。

[32]byte
[2*N] struct { x, y int32 }
[1000]*float64
[3][5]int
[2][2][2]float64  // 与[2]([2]([2]float64))相同

数组类型T不能有类型为T的元素,或包含T作为组件的类型,直接或间接,如果这些包含类型仅是数组或结构体类型。

// 无效数组类型
type (
T1 [10]T1                 // T1的元素类型是T1
T2 [10]struct{ f T2 }     // T2包含T2作为结构体的组件
T3 [10]T4                 // T3包含T3作为T4中结构体的组件
T4 struct{ f T3 }         // T4包含T4作为数组T3中结构体的组件
)

// 有效数组类型
type (
T5 [10]*T5                // T5包含T5作为指针的组件
T6 [10]func() T6          // T6包含T6作为函数类型的组件
T7 [10]struct{ f []T7 }   // T7包含T7作为结构体中切片的组件
)

切片类型

切片是底层数组连续段的描述符,提供对该数组中编号元素序列的访问。切片类型表示其元素类型所有数组的切片的集合。元素数称为切片的长度,永不为负。未初始化切片的值是nil

SliceType = "[" "]" ElementType .

切片s的长度可以使用内置函数len发现;与数组不同,它在执行期间可能变化。元素可以通过整数索引0到len(s)-1寻址。给定元素在切片中的索引可能小于其在底层数组中的索引。

切片一旦初始化,总是与保存其元素的底层数组相关联。切片因此与其数组及同一数组的其他切片共享存储;相比之下,不同数组总是表示不同的存储。

切片底层数组可能延伸到切片末尾之外。容量是这种延伸的度量:它是切片长度和切片后数组长度之和;可以通过从原始切片切片新切片来创建长度达到该容量的切片。切片a的容量可以使用内置函数cap(a)发现。

给定元素类型T的新初始化切片值可以使用内置函数make创建,该函数接受切片类型和指定长度和可选容量的参数。使用make创建的切片总是分配一个新的隐藏数组,返回的切片值引用该数组。也就是说,执行

make([]T, length, capacity)

产生与分配数组并切片它相同的切片,因此这两个表达式等价:

make([]int, 50, 100)
new([100]int)[0:50]

与数组一样,切片始终是一维的,但可以组合构造高维对象。对于数组的数组,内部数组在构造上总是相同长度;然而对于切片的切片(或数组的切片),内部长度可能动态变化。此外,内部切片必须单独初始化。

结构体类型

结构体是称为字段的有名元素序列,每个元素都有名称和类型。字段名称可以显式指定(IdentifierList)或隐式指定(EmbeddedField)。在结构体中,非空白字段名称必须是唯一的。

StructType    = "struct" "{" { FieldDecl ";" } "}" .
FieldDecl     = (IdentifierList Type | EmbeddedField) [ Tag ] .
EmbeddedField = [ "*" ] TypeName [ TypeArgs ] .
Tag           = string_lit .
// 空结构体。
struct {}

// 有6个字段的结构体。
struct {
x, y int
u float32
_ float32  // 填充
A *[]int
F func()
}

声明了类型但没有显式字段名称的字段称为嵌入字段。嵌入字段必须指定为类型名T或指向非接口类型名*T的指针,且T本身不能是指针类型或类型参数。未限定的类型名充当字段名。

// 有四个嵌入字段的结构体,类型为T1, *T2, P.T3和*P.T4
struct {
T1        // 字段名为T1
*T2       // 字段名为T2
P.T3      // 字段名为T3
*P.T4     // 字段名为T4
x, y int  // 字段名为x和y
}

以下声明是非法的,因为结构体类型中的字段名必须是唯一的:

struct {
T     // 与嵌入字段*T和*P.T冲突
*T    // 与嵌入字段T和*P.T冲突
*P.T  // 与嵌入字段T和*T冲突
}

结构体x中嵌入字段的字段或方法 f被称为提升,如果x.f是表示该字段或方法f的合法选择器

提升的字段表现得像结构体的普通字段,只是它们不能在复合字面量中用作字段名。

给定结构体类型S和类型名T,提升的方法按以下方式包含在结构体的方法集中:

  • 如果S包含嵌入字段TS*S方法集都包含接收器为T的提升方法。*S的方法集还包含接收器为*T的提升方法。
  • 如果S包含嵌入字段*TS*S的方法集都包含接收器为T*T的提升方法。

字段声明后可以跟一个可选的字符串字面量标签,它成为相应字段声明中所有字段的属性。空标签字符串等价于不存在的标签。标签通过反射接口可见,并参与结构体的类型标识,但除此之外被忽略。

struct {
x, y float64 ""  // 空标签字符串像不存在的标签
name string  "任何字符串都允许作为标签"
_    [4]byte "这不是结构体字段"
}

// 对应TimeStamp协议缓冲区的结构体。
// 标签字符串定义协议缓冲区字段号;
// 它们遵循reflect包概述的约定。
struct {
microsec  uint64 `protobuf:"1"`
serverIP6 uint64 `protobuf:"2"`
}

结构体类型T不能包含类型为T的字段,或包含T作为组件的类型,直接或间接,如果这些包含类型仅是数组或结构体类型。

// 无效结构体类型
type (
T1 struct{ T1 }            // T1包含T1的字段
T2 struct{ f [10]T2 }      // T2包含T2作为数组的组件
T3 struct{ T4 }            // T3包含T3作为T4中数组的组件
T4 struct{ f [10]T3 }      // T4包含T4作为T3在数组中的组件
)

// 有效结构体类型
type (
T5 struct{ f *T5 }         // T5包含T5作为指针的组件
T6 struct{ f func() T6 }   // T6包含T6作为函数类型的组件
T7 struct{ f [10][]T7 }    // T7包含T7作为数组中切片的组件
)

指针类型

指针类型表示给定类型变量的所有指针的集合,该类型称为指针的基类型。未初始化指针的nil

PointerType = "*" BaseType .
BaseType    = Type .
*Point
*[4]int

函数类型

函数类型表示具有相同参数和结果类型的所有函数的集合。未初始化函数类型变量的nil

FunctionType  = "func" Signature .
Signature     = Parameters [ Result ] .
Result        = Parameters | Type .
Parameters    = "(" [ ParameterList [ "," ] ] ")" .
ParameterList = ParameterDecl { "," ParameterDecl } .
ParameterDecl = [ IdentifierList ] [ "..." ] Type .

在参数或结果列表中,名称(IdentifierList)必须全部存在或全部不存在。如果存在,每个名称代表指定类型的一个项目(参数或结果),且签名中非空白名称必须是唯一的。如果不存在,每个类型代表该类型的一个项目。参数和结果列表总是用括号括起来,但如果有且仅有一个未命名的结果,它可以写成未加括号的形式。

函数签名中的最后一个传入参数可以有前缀为...的类型。具有这种参数的函数称为可变参数函数,可以用零个或多个参数调用该参数。

func()
func(x int) int
func(a, _ int, z float32) bool
func(a, b int, z float32) (bool)
func(prefix string, values ...int)
func(a, b int, z float64, opt ...interface{}) (success bool)
func(int, int, float64) (float64, *[]int)
func(n int) func(p *T)

接口类型

接口类型定义类型集。接口类型的变量可以存储类型集中任何类型的值。这种类型被称为实现接口。未初始化接口类型变量的nil

InterfaceType  = "interface" "{" { InterfaceElem ";" } "}" .
InterfaceElem  = MethodElem | TypeElem .
MethodElem     = MethodName Signature .
MethodName     = identifier .
TypeElem       = TypeTerm { "|" TypeTerm } .
TypeTerm       = Type | UnderlyingType .
UnderlyingType = "~" Type .

接口类型由接口元素列表指定。接口元素是方法类型元素,其中类型元素是一组或多类型项的并集。类型项是单个类型或单个潜在类型。

基本接口

在其最基本的形式中,接口指定方法(可能为空)列表。这种接口定义的类型集是实现所有这些方法的类型的集合,相应的方法集完全由接口指定的方法组成。完全由方法列表定义类型集的接口称为基本接口

// 简单的File接口。
interface {
Read([]byte) (int, error)
Write([]byte) (int, error)
Close() error
}

每个显式指定方法的名称必须是唯一的且非空白

interface {
String() string
String() string  // 非法:String不唯一
_(x int)         // 非法:方法必须有非空白名称
}

多个类型可能实现接口。例如,如果两个类型S1S2都有方法集

func (p T) Read(p []byte) (n int, err error)
func (p T) Write(p []byte) (n int, err error)
func (p T) Close() error

(其中T代表S1S2),那么File接口由S1S2实现,不管S1S2可能有的其他方法或共享的方法。

接口的每个成员类型都实现该接口。任何给定类型都可以实现几个不同的接口。例如,所有类型都实现空接口,它代表所有(非接口)类型的集合:

interface{}

为方便起见,预声明类型any是空接口的别名。[Go 1.18]

类似地,考虑这个接口规范,它出现在类型声明中,定义了一个名为Locker的接口:

type Locker interface {
Lock()
Unlock()
}

如果S1S2也实现

func (p T) Lock() { … }
func (p T) Unlock() { … }

它们也实现Locker接口以及File接口。

嵌入接口

在稍更一般的形式中,接口T可以使用(可能限定的)接口类型名E作为接口元素。这称为在T嵌入接口E [Go 1.14]。T的类型集是T的显式声明方法和嵌入接口类型集的交集。换句话说,T的类型集是实现T所有显式声明方法和E所有方法的类型集 [Go 1.18]。

type Reader interface {
Read(p []byte) (n int, err error)
Close() error
}

type Writer interface {
Write(p []byte) (n int, err error)
Close() error
}

// ReadWriter的方法是Read, Write, 和 Close。
type ReadWriter interface {
Reader  // 在ReadWriter的方法集中包含Reader的方法
Writer  // 在ReadWriter的方法集中包含Writer的方法
}

当嵌入接口时,相同名称的方法必须有相同签名。

type ReadCloser interface {
Reader   // includes methods of Reader in ReadCloser's method set
Close()  // illegal: signatures of Reader.Close and Close are different
}

通用接口

在其最一般的形式中,接口元素也可以是任意类型项T,或形式为~T的项,指定潜在类型T,或项的并集t<sub>1</sub>|t<sub>2</sub>|…|t<sub>n</sub> [Go 1.18]。结合方法规范,这些元素使接口的类型集得以精确定义如下:

  • 空接口的类型集是所有非接口类型的集合。
  • 非空接口的类型集是其接口元素类型集的交集。
  • 方法规范的类型集是方法集包含该方法的所有非接口类型的集合。
  • 非接口类型项的类型集仅由该类型组成的集合。
  • 形式为~T的项的类型集是潜在类型为T的所有类型的集合。
  • 项的并集t<sub>1</sub>|t<sub>2</sub>|…|t<sub>n</sub>的类型集是各项类型集的并集。

"所有非接口类型的集合"不仅指程序中声明的所有(非接口)类型,还包括所有可能程序中的所有可能类型,因此是无限的。同样,给定实现特定方法的所有非接口类型,这些类型的方法集的交集将恰好包含该方法,即使程序中的所有类型总是将该方法与另一个方法配对。

通过构造,接口的类型集从不包含接口类型。

// 仅表示类型int的接口。
interface {
int
}

// 表示所有潜在类型为int的类型的接口。
interface {
~int
}

// 表示具有潜在类型int并实现String方法的所有类型的接口。
interface {
~int
String() string
}

// 表示空类型集的接口:没有类型同时是int和string。
interface {
int
string
}

在形式为~T的项中,T的潜在类型必须是T本身,且T不能是接口。

type MyInt int

interface {
~[]byte  // []byte的潜在类型是它本身
~MyInt   // 非法:MyInt的潜在类型不是MyInt
~error   // 非法:error是接口
}

并集元素表示类型集的并集:

// Float接口表示所有浮点类型
// (包括任何其潜在类型是float32或float64的命名类型)。
type Float interface {
~float32 | ~float64
}

形式为T~T的项中的类型T不能是类型参数,且所有非接口项的类型集必须是两两不相交的(类型集的成对交集必须为空)。给定类型参数P

interface {
P                // 非法:P是类型参数
int | ~P         // 非法:P是类型参数
~int | MyInt     // 非法:~int和MyInt的类型集不相交(~int包括MyInt)
float32 | Float  // 类型集重叠但Float是接口
}

实现限制:并集(有多个项)不能包含预声明标识符comparable或指定方法的接口,或嵌入comparable或指定方法的接口。

基本接口只能用作类型约束,或用作其他用作约束的接口的元素。它们不能是值或变量的类型,或其他非接口类型的组件。

var x Float                     // 非法:Float不是基本接口

var x interface{} = Float(nil)  // 非法

type Floatish struct {
f Float                 // 非法
}

接口类型T不能嵌入直接或间接是T、包含T或嵌入T的类型元素。

// 非法:Bad不能嵌入自己
type Bad interface {
Bad
}

// 非法:Bad1不能使用Bad2嵌入自己
type Bad1 interface {
Bad2
}
type Bad2 interface {
Bad1
}

// 非法:Bad3不能包含Bad3的并集
type Bad3 interface {
~int | ~string | Bad3
}

// 非法:Bad4不能包含以Bad4为元素类型的数组
type Bad4 interface {
[10]Bad4
}

实现接口

如果满足以下条件,类型T实现接口I

  • T不是接口且是I类型集的元素;或
  • T是接口且T的类型集是I类型集的子集。

如果T实现接口,则T类型的值实现接口。

映射类型

映射是无序的元素组,元素为一种类型(称为元素类型),由另一类型的唯一索引(称为键类型)。未初始化映射的nil

MapType = "map" "[" KeyType "]" ElementType .
KeyType = Type .

键类型的操作数必须完全定义比较操作符 ==!=;因此键类型不能是函数、映射或切片。如果键类型是接口类型,则这些比较操作符必须为动态键值定义;失败将导致运行时恐慌

map[string]int
map[*T]struct{ x, y float64 }
map[string]interface{}

映射中元素的数量称为其长度。对于映射m,可以使用内置函数len发现长度,且在执行期间可能变化。在执行期间,可以使用赋值添加元素,使用索引表达式检索元素;可以使用deleteclear内置函数删除元素。

可以使用内置函数make创建新的空映射值,该函数接受映射类型和一个可选容量提示作为参数:

make(map[string]int)
make(map[string]int, 100)

初始容量不限制其大小:映射会增长以适应其中存储的项目数量,nil映射除外。nil映射等效于空映射,只是不能添加元素。

通道类型

通道提供了一种机制,用于并发执行的函数通过指定元素类型的发送接收值进行通信。未初始化通道的nil

ChannelType = ( "chan" | "chan" "<-" | "<-" "chan" ) ElementType .

可选的<-操作符指定通道的方向发送接收。如果指定了方向,通道是定向的,否则是双向的。通道可以通过赋值或显式转换限制为仅发送或仅接收。

chan T          // 可用于发送和接收类型T的值
chan<- float64  // 只能用于发送float64
<-chan int      // 只能用于接收ints

<-操作符与最左边的chan关联:

chan<- chan int    // 与chan<- (chan int)相同
chan<- <-chan int  // 与chan<- (<-chan int)相同
<-chan <-chan int  // 与<-chan (<-chan int)相同
chan (<-chan int)

可以使用内置函数make创建新的初始化通道值,该函数接受通道类型和一个可选容量作为参数:

make(chan int, 100)

容量(以元素数量计)设置通道中缓冲区的大小。如果容量为零或省略,通道是无缓冲的,只有当发送方和接收方都准备好时通信才成功。否则,通道是有缓冲的,只要缓冲区未满(发送)或非空(接收),通信就无需阻塞。nil通道永远无法进行通信。

通道可以使用内置函数close关闭。使用接收操作符的多值赋值形式可以报告接收的值是否在通道关闭前发送。

单个通道可以在发送语句接收操作以及内置函数caplen的调用中由任意数量的goroutines使用,无需进一步同步。通道充当先进先出队列。例如,如果一个goroutine在通道上发送值,第二个goroutine接收它们,则值按发送顺序接收。

类型和值的属性

值的表示

预声明类型(接口anyerror除外)、数组和结构体的值是独立的:每个这样的值包含其所有数据的完整副本,且这些类型的变量存储整个值。例如,数组变量为数组的所有元素提供存储(变量)。相应的零值是特定于值类型的;它们永远不是nil

nil指针、函数、切片、映射和通道值包含对基础数据的引用,这些数据可能被多个值共享:

  • 指针值是引用保存指针基类型值的变量。
  • 函数值包含对(可能匿名的)函数和封闭变量的引用。
  • 切片值包含切片长度、容量和对其底层数组的引用。
  • 映射或通道值是对映射或通道特定于实现的数据结构的引用。

接口值可能是独立的,也可能包含对基础数据的引用,取决于接口的动态类型。预声明标识符nil是值可以包含引用的类型的零值。

当多个值共享基础数据时,更改一个值可能会更改另一个值。例如,更改切片的元素将更改底层数组中所有共享该数组切片的元素。

潜在类型

每个类型T都有一个潜在类型:如果T是预声明的布尔、数值或字符串类型之一,或者是类型字面量,则相应的潜在类型是T本身。否则,T的潜在类型是T声明中引用类型的潜在类型。对于总是接口的类型参数,该类型是它的类型约束的潜在类型。

type (
A1 = string
A2 = A1
)

type (
B1 string
B2 B1
B3 []B1
B4 B3
)

func f[P any](x P) { … }

stringA1A2B1B2的潜在类型是string[]B1B3B4的潜在类型是[]B1P的潜在类型是interface{}

类型标识

两种类型要么是相同的("相同"),要么是不同的

命名类型总是与其他任何类型不同。否则,如果它们的潜在类型字面量结构等价,则两种类型是相同的;也就是说,它们具有相同的字面量结构,相应的组件具有相同的类型。详细来说:

  • 如果两种数组类型具有相同的元素类型且长度相同,则它们是相同的。
  • 如果两种切片类型具有相同的元素类型,则它们是相同的。
  • 如果两种结构体类型具有相同顺序的字段,且对应字段对具有相同的名称、相同的类型、相同的标签,并且要么都是嵌入的,要么都不是嵌入的,则它们是相同的。来自不同包的未导出字段名称总是不同的。
  • 如果两种指针类型具有相同的基类型,则它们是相同的。
  • 如果两种函数类型具有相同数量的参数和结果值,对应的参数和结果类型是相同的,且要么都是可变参数,要么都不是,则它们是相同的。参数和结果名称不需要匹配。
  • 如果两种接口类型定义相同的类型集,则它们是相同的。
  • 如果两种映射类型具有相同的键和元素类型,则它们是相同的。
  • 如果两种通道类型具有相同的元素类型且方向相同,则它们是相同的。
  • 如果两种实例化类型的定义类型和所有类型参数都是相同的,则它们是相同的。

给定声明

type (
A0 = []string
A1 = A0
A2 = struct{ a, b int }
A3 = int
A4 = func(A3, float64) *A0
A5 = func(x int, _ float64) *[]string

B0 A0
B1 []string
B2 struct{ a, b int }
B3 struct{ a, c int }
B4 func(int, float64) *B0
B5 func(x int, y float64) *A1

C0 = B0
D0[P1, P2 any] struct{ x P1; y P2 }
E0 = D0[int, string]
)

以下类型是相同的:

  • A0A1[]string
  • A2struct{ a, b int }
  • A3int
  • A4func(int, float64) *[]stringA5
  • B0C0
  • D0[int, string]E0
  • []int[]int
  • struct{ a, b *B5 }struct{ a, b *B5 }
  • func(x int, y float64) *[]stringfunc(int, float64) (result *[]string)A5

B0B1不同,因为它们是由不同的类型定义创建的新类型;func(int, float64) *B0func(x int, y float64) *[]string不同,因为B0不同于[]string;并且P1P2不同,因为它们是不同类型的参数。D0[int, string]struct{ x int; y string }不同,因为前者是实例化的定义类型,而后者是类型字面量(但它们仍然是可分配的)。

可分配性

如果满足以下条件之一,则类型V的值x可分配给类型T变量("x可分配给T"):

  • VT是相同的。
  • VT具有相同的潜在类型,但不是类型参数,且VT中至少有一个不是命名类型
  • VT是具有相同元素类型的通道类型,V是双向通道,且VT中至少有一个不是命名类型
  • T是接口类型,但不是类型参数,且x实现 T
  • x是预声明标识符nil,且T是指针、函数、切片、映射、通道或接口类型,但不是类型参数。
  • x常量可表示T类型的值。

此外,如果x的类型VT是类型参数,则x可分配给类型为T的变量,如果满足以下条件之一:

  • x是预声明标识符nilT是类型参数,且x可分配给T类型集中的每个类型。
  • V不是命名类型T是类型参数,且x可分配给T类型集中的每个类型。
  • V是类型参数且T不是命名类型,且V类型集中的每个类型的值都可分配给T

可表示性

如果满足以下条件之一,则常量 x可由T类型的值表示,其中T不是类型参数

  • x属于由T确定的值集。
  • T浮点类型x可以舍入到T的精度而不会溢出。舍入使用IEEE 754舍入到最近偶数规则,但IEEE负零进一步简化为无符号零。注意,常量值永远不会导致IEEE负零、NaN或无穷大。
  • T是复数类型,且x组成部分 real(x)imag(x)可由T的组成部分类型(float32float64)的值表示。

如果T是类型参数,则x可由T类型的值表示,如果x可由T类型集中的每个类型的值表示。

x                   T           x可由T类型的值表示,因为

'a'                 byte        97在字节值集合中
97                  rune        rune是int32的别名,且97在32位整数集合中
"foo"               string      "foo"在字符串值集合中
1024                int16       1024在16位整数集合中
42.0                byte        42在无符号8位整数集合中
1e10                uint64      10000000000在无符号64位整数集合中
2.718281828459045   float32     2.718281828459045舍入到2.7182817,在float32值集合中
-1e-1000            float64     -1e-1000舍入到IEEE -0.0,进一步简化为0.0
0i                  int         0是整数值
(42 + 0i)           float32     42.0(虚部为零)在float32值集合中
x                   T           x不能由T类型的值表示,因为

0                   bool        0不在布尔值集合中
'a'                 string      'a'是rune,它不在字符串值集合中
1024                byte        1024不在无符号8位整数集合中
-1                  uint16      -1不在无符号16位整数集合中
1.1                 int         1.1不是整数值
42i                 float32     (0 + 42i)不在float32值集合中
1e1000              float64     1e1000在舍入后溢出到IEEE +Inf

方法集

类型的方法集决定了可以在该类型的操作数调用的方法。每种类型都有一个关联的(可能为空的)方法集:

  • 定义类型 T的方法集包括所有接收器类型为T方法
  • 指向定义类型T的指针(其中T既不是指针也不是接口)的方法集包括所有接收器为*TT声明的方法。
  • 接口类型的方法集是接口类型集中每种类型的方法集的交集(结果方法集通常只是接口中声明的方法集)。

进一步规则适用于包含嵌入字段的结构体(和指向结构体的指针),如结构体类型部分所述。任何其他类型都有空方法集。

在方法集中,每个方法必须具有唯一的非空白方法名称

是可能为空的声明和语句序列,位于匹配的大括号内。

Block         = "{" StatementList "}" .
StatementList = { Statement ";" } .

除了源代码中的显式块外,还有隐式块:

  1. 宇宙块包含所有Go源代码。
  2. 每个都有一个包块,包含该包的所有Go源代码。
  3. 每个文件都有一个文件块,包含该文件中的所有Go源代码。
  4. 每个"if""for""switch"语句被认为在其自己的隐式块中。
  5. "switch""select"语句中的每个子句都充当一个隐式块。

块嵌套并影响作用域

声明和作用域

声明将非空白标识符绑定到常量类型类型参数变量函数标签。程序中每个标识符都必须声明。在同一个块中,没有标识符可以声明两次,且没有标识符可以在文件块和包块中同时声明。

空白标识符可以像其他标识符一样在声明中使用,但它不引入绑定,因此不被声明。在包块中,标识符init只能用于init函数声明,且与空白标识符一样,它不引入新的绑定。

Declaration  = ConstDecl | TypeDecl | VarDecl .
TopLevelDecl = Declaration | FunctionDecl | MethodDecl .

声明标识符的作用域是源代码中标识符表示指定常量、类型、变量、函数、标签或包的范围。

Go使用进行词法作用域:

  1. 预声明标识符的作用域是宇宙块。
  2. 在顶层(函数外部)声明的常量、类型、变量或函数(但不是方法)的标识符的作用域是包块。
  3. 导入包的包名的作用域是包含导入声明的文件的文件块。
  4. 表示方法接收器、函数参数或结果变量的标识符的作用域是函数体。
  5. 表示函数的类型参数或方法接收者声明的类型参数标识符的作用域从函数名后开始,到函数体结束时结束。
  6. 表示类型的类型参数的标识符的作用域从类型名后开始,到TypeSpec结束时结束。
  7. 在函数内声明的常量或变量标识符的作用域从ConstSpec或VarSpec(短变量声明的ShortVarDecl)结束时开始,到最内层包含块结束时结束。
  8. 在函数内声明的类型标识符的作用域从TypeSpec中的标识符开始,到最内层包含块结束时结束。

在块中声明的标识符可以在内部块中重新声明。当内部声明的标识符在作用域时,它表示内部声明。

包子句不是声明;包名不出现在任何作用域中。它的目的是标识属于同一个的文件,并指定导入声明的默认包名。

标签作用域

标签由标签语句声明,并在"break""continue""goto"语句中使用。定义了从未使用的标签是非法的。与其他标识符不同,标签不是块作用域,且不与非标签标识符冲突。标签的作用域是声明它的函数体,不包括任何嵌套函数的体。

空白标识符

空白标识符由下划线字符_表示。它在声明操作数赋值语句中作为匿名占位符而不是常规(非空白)标识符使用,具有特殊含义。

预声明标识符

以下标识符在宇宙块中隐式声明 [Go 1.18] [Go 1.21]:

Types:
any bool byte comparable
complex64 complex128 error float32 float64
int int8 int16 int32 int64 rune string
uint uint8 uint16 uint32 uint64 uintptr

Constants:
true false iota

Zero value:
nil

Functions:
append cap clear close complex copy delete imag len
make max min new panic print println real recover

导出标识符

标识符可以导出,以允许从另一个包访问它。如果满足以下两个条件,则标识符是导出的:

  1. 标识符名称的首字符是Unicode大写字母(Unicode字符类别Lu);且
  2. 标识符在包块中声明,或它是字段名方法名

所有其他标识符未导出。

标识符唯一性

给定一组标识符,如果一个标识符与该组中的其他标识符不同,则称该标识符为唯一。如果拼写不同,或出现在不同中且未导出,则两个标识符不同。否则,它们是相同的。

常量声明

常量声明将标识符列表(常量名)绑定到常量表达式的值列表。标识符数量必须与表达式数量相等,且左边的第n个标识符绑定到右边的第n个表达式的值。

ConstDecl      = "const" ( ConstSpec | "(" { ConstSpec ";" } ")" ) .
ConstSpec      = IdentifierList [ [ Type ] "=" ExpressionList ] .
IdentifierList = identifier { "," identifier } .
ExpressionList = Expression { "," Expression } .

如果类型存在,所有常量采用指定的类型,表达式必须可分配给该类型,该类型不能是类型参数。如果省略类型,常量采用对应表达式的类型。如果表达式值是未类型化的常量,则声明的常量保持未类型化,且常量标识符表示常量值。例如,如果表达式是浮点字面量,即使字面量的分数部分为零,常量标识符也表示浮点常量。

const Pi float64 = 3.14159265358979323846
const zero = 0.0         // 未类型化浮点常量
const (
size int64 = 1024
eof        = -1  // 未类型化整型常量
)
const a, b, c = 3, 4, "foo"  // a = 3, b = 4, c = "foo",未类型化整型和字符串常量
const u, v float32 = 0, 3    // u = 0.0, v = 3.0

在括号内的const声明列表中,除了第一个ConstSpec外,任何ConstSpec都可以省略表达式列表。空列表等价于文本替换前一个非空表达式列表及其类型(如果有的话)。因此,省略表达式列表等价于重复前一个列表。标识符数量必须等于前一个列表中的表达式数量。结合iota常量生成器,此机制允许轻量级顺序值声明:

const (
Sunday = iota
Monday
Tuesday
Wednesday
Thursday
Friday
Partyday
numberOfDays  // 此常量未导出
)

Iota

常量声明中,预声明标识符iota表示连续的无类型整数常量。其值是相应ConstSpec在该常量声明中的索引,从零开始。它可用于构造一组相关的常量:

const (
c0 = iota  // c0 == 0
c1 = iota  // c1 == 1
c2 = iota  // c2 == 2
)

const (
a = 1 << iota  // a == 1  (iota == 0)
b = 1 << iota  // b == 2  (iota == 1)
c = 3          // c == 3  (iota == 2, unused)
d = 1 << iota  // d == 8  (iota == 3)
)

const (
u         = iota * 42  // u == 0     (无类型整型常量)
v float64 = iota * 42  // v == 42.0  (float64常量)
w         = iota * 42  // w == 84    (无类型整型常量)
)

const x = iota  // x == 0
const y = iota  // y == 0

根据定义,在同一个ConstSpec中多次使用iota具有相同的值:

const (
bit0, mask0 = 1 << iota, 1<<iota - 1  // bit0 == 1, mask0 == 0  (iota == 0)
bit1, mask1                           // bit1 == 2, mask1 == 1  (iota == 1)
_, _                                  //                        (iota == 2, unused)
bit3, mask3                           // bit3 == 8, mask3 == 7  (iota == 3)
)

最后一个例子利用了最后一个非空表达式列表的隐式重复

类型声明

类型声明将标识符(类型名)绑定到类型。类型声明有两种形式:别名声明和类型定义。

TypeDecl = "type" ( TypeSpec | "(" { TypeSpec ";" } ")" ) .
TypeSpec = AliasDecl | TypeDef .

别名声明

别名声明将标识符绑定到给定类型 [Go 1.9]。

AliasDecl = identifier [ TypeParameters ] "=" Type .

在标识符的作用域内,它作为给定类型的别名

type (
nodeList = []*Node  // nodeList和[]*Node是相同类型
Polar    = polar    // Polar和polar表示相同类型
)

如果别名声明指定了类型参数 [Go 1.24],则类型名表示泛型别名。泛型别名在使用时必须被实例化

type set[P comparable] = map[P]bool

在别名声明中,给定类型不能是类型参数。

type A[P any] = P    // 非法:P是类型参数

类型定义

类型定义创建具有相同潜在类型和操作的新定义类型,并将标识符(类型名)绑定到它。

TypeDef = identifier [ TypeParameters ] Type .

新类型被称为定义类型。它与任何其他类型都不同,包括创建它的类型。

type (
Point struct{ x, y float64 }  // Point和struct{ x, y float64 }是不同的类型
polar Point                   // polar和Point表示不同的类型
)

type TreeNode struct {
left, right *TreeNode
value any
}

type Block interface {
BlockSize() int
Encrypt(src, dst []byte)
Decrypt(src, dst []byte)
}

定义类型可以有与其关联的方法。它不从给定类型继承任何方法,但接口类型或复合类型元素的方法集保持不变:

// Mutex是一个具有Lock和Unlock两种方法的数据类型。
type Mutex struct         { /* Mutex字段 */ }
func (m *Mutex) Lock()    { /* Lock实现 */ }
func (m *Mutex) Unlock()  { /* Unlock实现 */ }

// NewMutex具有与Mutex相同的组成,但其方法集为空。
type NewMutex Mutex

// PtrMutex的潜在类型*Mutex的方法集保持不变,
// 但PtrMutex的方法集为空。
type PtrMutex *Mutex

// PrintableMutex的方法集包含与其嵌入字段Mutex关联的方法
// Lock和Unlock。
type PrintableMutex struct {
Mutex
}

// MyBlock是一个与Block具有相同方法集的接口类型。
type MyBlock Block

类型定义可用于定义不同的布尔、数值或字符串类型,并与它们关联方法:

type TimeZone int

const (
EST TimeZone = -(5 + iota)
CST
MST
PST
)

func (tz TimeZone) String() string {
return fmt.Sprintf("GMT%+dh", tz)
}

如果类型定义指定了类型参数,则类型名表示泛型类型。泛型类型在使用时必须被实例化

type List[T any] struct {
next  *List[T]
value T
}

在类型定义中,给定类型不能是类型参数。

type T[P any] P    // 非法:P是类型参数

func f[T any]() {
type L T   // 非法:T是封闭函数声明的类型参数
}

泛型类型也可以有与其关联的方法。在这种情况下,方法接收器必须声明与泛型类型定义中相同数量的类型参数。

// 方法Len返回链表l中的元素数量。
func (l *List[T]) Len() int  { … }

类型参数声明

类型参数列表声明泛型函数或类型声明的类型参数。类型参数列表看起来像普通的函数参数列表,除了类型参数名称都必须存在且列表用方括号而不是括号包围 [Go 1.18]。

TypeParameters = "[" TypeParamList [ "," ] "]" .
TypeParamList  = TypeParamDecl { "," TypeParamDecl } .
TypeParamDecl  = IdentifierList TypeConstraint .

列表中所有非空白名称必须是唯一的。每个名称声明一个类型参数,它是新的不同命名类型,作为声明中(尚未)未知类型的占位符。类型参数在泛型函数或类型被实例化时被替换为类型参数

[P any]
[S interface{ ~[]byte|string }]
[S ~[]E, E any]
[P Constraint[int]]
[_ any]

就像每个普通函数参数都有参数类型一样,每个类型参数都有相应的(元)类型,这被称为其类型约束

当泛型类型的类型参数列表声明单个类型参数P且约束C使得文本P C形成有效表达式时,会产生解析歧义:

type T[P *C] …
type T[P (C)] …
type T[P *C|Q] …

在这些罕见情况下,类型参数列表与表达式无法区分,类型声明被解析为数组类型声明。为了消除歧义,将约束嵌入接口或使用尾随逗号:

type T[P interface{*C}] …
type T[P *C,] …

类型参数也可以由泛型类型的方法声明的接收器规范声明。

在泛型类型T的类型参数列表中,类型约束不能(直接,或间接通过另一个泛型类型的类型参数列表)引用T

type T1[P T1[P]] …                    // 非法:T1引用自身
type T2[P interface{ T2[int] }] …     // 非法:T2引用自身
type T3[P interface{ m(T3[int])}] …   // 非法:T3引用自身
type T4[P T5[P]] …                    // 非法:T4引用T5且
type T5[P T4[P]] …                    //          T5引用T4

type T6[P int] struct{ f *T6[P] }     // 合法:对T6的引用不在类型参数列表中

类型约束

类型约束 是一种接口,它定义了相应类型参数允许的类型参数集合,并控制该类型参数值支持的操作 [Go 1.18]。

TypeConstraint = TypeElem .

如果约束是形如 interface{E} 的接口字面量,其中 E 是嵌入的类型元素(不是方法),在类型参数列表中,为了方便可以省略外围的 interface{ … }

[T []P]                      // = [T interface{[]P}]
[T ~int]                     // = [T interface{~int}]
[T int|string]               // = [T interface{int|string}]
type Constraint ~int         // 非法: ~int 不在类型参数列表中

预声明接口类型 comparable 表示所有严格可比较的非接口类型的集合 [Go 1.18]。

尽管非类型参数的接口是可比较的,但它们不是严格可比较的,因此它们不实现 comparable。但是,它们满足 comparable

int                          // 实现 comparable (int 是严格可比较的)
[]byte                       // 不实现 comparable (切片不可比较)
interface{}                  // 不实现 comparable (见上文)
interface{ ~int | ~string }  // 仅类型参数: 实现 comparable (int, string 类型是严格可比较的)
interface{ comparable }      // 仅类型参数: 实现 comparable (comparable 实现自身)
interface{ ~int | ~[]byte }  // 仅类型参数: 不实现 comparable (切片不可比较)
interface{ ~struct{ any } }  // 仅类型参数: 不实现 comparable (字段 any 不是严格可比较的)

comparable 接口和(直接或间接)嵌入了 comparable 的接口只能用作类型约束。它们不能作为值或变量的类型,也不能作为其他非接口类型的组成部分。

满足类型约束

如果类型参数 TC 定义的类型集合中的元素,则称类型参数 T 满足类型约束 C;换句话说,如果 T 实现C。作为例外,严格可比较的类型约束也可以通过可比较的(不一定严格可比较)类型参数满足 [Go 1.20]。更精确地说:

类型 T 满足 约束 C,如果

类型参数           类型约束                        // 约束满足

int                interface{ ~int }              // 满足: int 实现 interface{ ~int }
string             comparable                     // 满足: string 实现 comparable (string 是严格可比较的)
[]byte             comparable                     // 不满足: 切片不可比较
any                interface{ comparable; int }   // 不满足: any 不实现 interface{ int }
any                comparable                     // 满足: any 是可比较的并实现基本接口 any
struct{f any}      comparable                     // 满足: struct{f any} 是可比较的并实现基本接口 any
any                interface{ comparable; m() }   // 不满足: any 不实现基本接口 interface{ m() }
interface{ m() }   interface{ comparable; m() }   // 满足: interface{ m() } 是可比较的并实现基本接口 interface{ m() }

由于约束满足规则中的例外,比较类型参数类型的操作数可能在运行时 panic(即使可比较的类型参数始终是严格可比较的)。

变量声明

变量声明会创建一个或多个变量,将相应的标识符与它们绑定,并为每个变量提供类型和初始值。

VarDecl = "var" ( VarSpec | "(" { VarSpec ";" } ")" ) .
VarSpec = IdentifierList ( Type [ "=" ExpressionList ] | "=" ExpressionList ) .
var i int
var U, V, W float64
var k = 0
var x, y float32 = -1, -2
var (
i       int
u, v, s = 2.0, 3.0, "bar"
)
var re, im = complexSqrt(-1)
var _, found = entries[name]  // 映射查找;只关心 "found"

如果提供了表达式列表,则按照赋值语句的规则初始化变量。否则,每个变量将初始化为它的零值

如果存在类型,则每个变量都将被赋予该类型。否则,每个变量将获得相应初始化值的类型。如果该值是无类型常量,则首先将其隐式转换为它的默认类型;如果它是无类型的布尔值,则首先隐式转换为 bool 类型。不能使用预声明标识符 nil 来初始化没有显式类型的变量。

var d = math.Sin(0.5)  // d 是 float64
var i = 42             // i 是 int
var t, ok = x.(T)      // t 是 T,ok 是 bool
var n = nil            // 非法

实现限制:如果变量从未被使用,编译器可以禁止在函数体内声明变量。

短变量声明

短变量声明 使用如下语法:

ShortVarDecl = IdentifierList ":=" ExpressionList .

它是省略了类型的常规变量声明的简写形式:

"var" IdentifierList "=" ExpressionList .
i, j := 0, 10
f := func() int { return 7 }
ch := make(chan int)
r, w, _ := os.Pipe()  // os.Pipe() 返回一对已连接的文件和一个错误(如果有)
_, y, _ := coord(p)   // coord() 返回三个值;只关心 y 坐标

与常规变量声明不同,短变量声明可以_重新声明_变量,前提是它们最初已在同一块中(如果块是函数体,则为参数列表)以相同类型声明,并且至少有一个非变量是新的。因此,重新声明只能出现在多变量短声明中。重新声明不会引入新变量;它只是为原始变量分配新值。:= 左侧的非空变量名必须是唯一的

field1, offset := nextField(str, 0)
field2, offset := nextField(str, offset)  // 重新声明 offset
x, y, x := 1, 2, 3                        // 非法: x 在 := 左侧重复

短变量声明只能出现在函数内部。在某些上下文中,例如 "if""for""switch" 语句的初始化部分,它们可用于声明本地临时变量。

函数声明

函数声明将标识符(即_函数名_)与函数绑定。

FunctionDecl = "func" FunctionName [ TypeParameters ] Signature [ FunctionBody ] .
FunctionName = identifier .
FunctionBody = Block .

如果函数的签名声明了结果参数,则函数体的语句列表必须以终止语句结束。

func IndexRune(s string, r rune) int {
for i, c := range s {
if c == r {
return i
}
}
// 无效: 缺少 return 语句
}

如果函数声明指定了类型参数,则函数名表示一个_泛型函数_。泛型函数在使用前必须实例化

func min[T ~int|~float64](x, y T) T {
if x < y {
return x
}
return y
}

没有类型参数的函数声明可以省略函数体。这种声明提供了在 Go 外部实现的函数的签名,例如汇编程序。

func flushICache(begin, end uintptr)  // 在外部实现

方法声明

方法是具有_接收者_的函数。方法声明将标识符(即_方法名_)与方法绑定,并将方法与接收者的_基本类型_关联。

MethodDecl = "func" Receiver MethodName Signature [ FunctionBody ] .
Receiver   = Parameters .

接收者通过位于方法名之前的额外参数部分指定。该参数部分必须声明一个非可变参数,即接收者。其类型必须是已定义的类型 T 或指向已定义类型 T 的指针,可能后跟用方括号括起来的类型参数名称列表 [P1, P2, …]T 被称为接收者_基本类型_。接收者的基本类型不能是指针或接口类型,并且它必须在同一包中定义。方法被称为_绑定_到其接收者的基本类型,方法名仅在类型 T*T选择器中可见。

接收者标识符在方法签名中必须是唯一的。如果接收者的值在方法体内未被引用,则可以在声明中省略其标识符。这通常也适用于函数和方法的参数。

对于基本类型,绑定到它的非空方法名必须是唯一的。如果基本类型是结构体类型,则非空方法和字段名必须不同。

给定已定义的类型 Point,声明

func (p *Point) Length() float64 {
return math.Sqrt(p.x * p.x + p.y * p.y)
}

func (p *Point) Scale(factor float64) {
p.x *= factor
p.y *= factor
}

将方法 LengthScale 与接收者类型 *Point 绑定到基本类型 Point

如果接收者的基本类型是泛型类型,则接收者规范必须声明相应的方法使用的类型参数。这使得接收者的类型参数对方法可用。从语法上讲,这种类型参数声明看起来像接收者基本类型的实例化:类型参数必须是表示正在声明的类型参数的标识符,每个接收者基本类型的类型参数对应一个。类型参数名不需要与接收者基本类型定义中的相应参数名匹配,所有非空参数名在接收者参数部分和方法签名中必须是唯一的。接收者类型参数约束由接收者基本类型定义隐含:相应的类型参数具有相应的约束。

type Pair[A, B any] struct {
a A
b B
}

func (p Pair[A, B]) Swap() Pair[B, A]  { … }  // 接收者声明 A, B
func (p Pair[First, _]) First() First  { … }  // 接收者声明 First,对应 Pair 中的 A

如果接收者类型由(指向)别名表示,则别名不能是泛型的,也不能表示实例化的泛型类型,无论是直接还是通过另一个别名间接表示,也不考虑指针间接。

type GPoint[P any] = Point
type HPoint        = *GPoint[int]
type IPair         = Pair[int, int]

func (*GPoint[P]) Draw(P)   { … }  // 非法: 别名不能是泛型的
func (HPoint) Draw(P)       { … }  // 非法: 别名不能表示已实例化的类型 GPoint[int]
func (*IPair) Second() int  { … }  // 非法: 别名不能表示已实例化的类型 Pair[int, int]

表达式

表达式通过将运算符和函数应用于操作数来指定值的计算。

操作数

操作数表示表达式中的基本值。操作数可以是字面量、(可能限定的)非标识符,表示常量变量函数,或者括号内的表达式。

Operand     = Literal | OperandName [ TypeArgs ] | "(" Expression ")" .
Literal     = BasicLit | CompositeLit | FunctionLit .
BasicLit    = int_lit | float_lit | imaginary_lit | rune_lit | string_lit .
OperandName = identifier | QualifiedIdent .

表示泛型函数的操作数名称后面可以跟一个类型参数列表;结果操作数是实例化的函数。

空标识符只能出现在赋值语句的左侧。

实现限制:如果操作数的类型是具有空类型集合类型参数,编译器无需报告错误。具有此类类型参数的函数无法实例化;任何尝试都将在实例化位置导致错误。

限定标识符

限定标识符 是带有包名前缀的标识符。包名和标识符都不能是的。

QualifiedIdent = PackageName "." identifier .

限定标识符访问不同包中的标识符,该包必须导入。该标识符必须是导出的,并在该包的包块中声明。

math.Sin // 表示 math 包中的 Sin 函数

复合字面量

复合字面量每次求值时都会为结构体、数组、切片和映射构造新值。它们由字面量的类型后跟一个用大括号括起来的元素列表组成。每个元素前面可以有相应的键。

CompositeLit = LiteralType LiteralValue .
LiteralType  = StructType | ArrayType | "[" "..." "]" ElementType |
               SliceType | MapType | TypeName [ TypeArgs ] .
LiteralValue = "{" [ ElementList [ "," ] ] "}" .
ElementList  = KeyedElement { "," KeyedElement } .
KeyedElement = [ Key ":" ] Element .
Key          = FieldName | Expression | LiteralValue .
FieldName    = identifier .
Element      = Expression | LiteralValue .

除非 LiteralType 是类型参数,否则其底层类型必须是结构体、数组、切片或映射类型(语法强制此约束,除非类型作为 TypeName 给出)。如果 LiteralType 是类型参数,则其类型集合中的所有类型必须具有相同的底层类型,且必须是有效的复合字面量类型。元素和键的类型必须是 可赋值的到类型 T 的相应字段、元素和键类型;没有额外的转换。对于结构体字面量,键解释为字段名;对于数组和切片字面量,键解释为索引;对于映射字面量,键解释为键。对于映射字面量,所有元素必须有键。指定具有相同字段名或常量键值的多个元素是错误的。对于非常数映射键,请参阅求值顺序部分。

对于结构体字面量,适用以下规则:

  • 键必须是结构体类型中声明的字段名。
  • 不包含任何键的元素列表必须按字段声明的顺序列出每个结构体字段的元素。
  • 如果任何元素有键,则每个元素都必须有键。
  • 包含键的元素列表不需要为每个结构体字段提供元素。省略的字段将获取该字段的零值。
  • 字面量可以省略元素列表;这样的字面量求值为其类型的零值。
  • 为属于不同包的结构体的非导出字段指定元素是错误的。

给定声明

type Point3D struct { x, y, z float64 }
type Line struct { p, q Point3D }

可以编写

origin := Point3D{}                            // Point3D 的零值
line := Line{origin, Point3D{y: -4, z: 12.3}}  // line.q.x 的零值

对于数组和切片字面量,适用以下规则:

  • 每个元素都有一个关联的整数索引,标记其在数组中的位置。
  • 带键的元素使用键作为其索引。键必须是非负常量,可表示int 类型的值;如果键有类型,则必须是整数类型
  • 不带键的元素使用前一个元素的索引加一。如果第一个元素没有键,则其索引为零。

取地址复合字面量会生成一个指向用字面量值初始化的唯一变量的指针。

var pointer *Point3D = &Point3D{y: 1000}

注意,切片或映射类型的零值与同类型的初始化但空值不同。因此,对空切片或映射复合字面量取地址的效果与使用new分配新切片或映射值的效果不同。

p1 := &[]int{}    // p1 指向一个初始化的空切片,值为 []int{},长度为 0
p2 := new([]int)  // p2 指向一个未初始化的切片,值为 nil,长度为 0

数组字面量的长度是字面量类型中指定的长度。如果字面量中提供的元素少于长度,则缺失的元素将设置为数组元素类型的零值。提供超出数组索引范围的索引值是错误的。符号 ... 指定数组长度等于最大元素索引加一。

buffer := [10]string{}             // len(buffer) == 10
intSet := [6]int{1, 2, 3, 5}       // len(intSet) == 6
days := [...]string{"Sat", "Sun"}  // len(days) == 2

切片字面量描述整个底层数组字面量。因此,切片字面量的长度和容量是最大元素索引加一。切片字面量具有以下形式

[]T{x1, x2, … xn}

并且是应用于数组的切片操作的简写:

tmp := [n]T{x1, x2, … xn}
tmp[0 : n]

在数组、切片或映射类型 T 的复合字面量中,如果元素或映射键本身是复合字面量,则可以省略相应的字面量类型(如果它与 T 的元素或键类型相同)。类似地,如果元素或键是复合字面量的地址,则可以省略 &T(当元素或键类型为 *T 时)。

[...]Point{{1.5, -3.5}, {0, 0}}     // 等同于 [...]Point{Point{1.5, -3.5}, Point{0, 0}}
[][]int{{1, 2, 3}, {4, 5}}          // 等同于 [][]int{[]int{1, 2, 3}, []int{4, 5}}
[][]Point{{{0, 1}, {1, 2}}}         // 等同于 [][]Point{[]Point{Point{0, 1}, Point{1, 2}}}
map[string]Point{"orig": {0, 0}}    // 等同于 map[string]Point{"orig": Point{0, 0}}
map[Point]string{{0, 0}: "orig"}    // 等同于 map[Point]string{Point{0, 0}: "orig"}

type PPoint *Point
[2]*Point{{1.5, -3.5}, {}}          // 等同于 [2]*Point{&Point{1.5, -3.5}, &Point{}}
[2]PPoint{{1.5, -3.5}, {}}          // 等同于 [2]PPoint{PPoint(&Point{1.5, -3.5}), PPoint(&Point{})}

当使用 LiteralType 的 TypeName 形式的复合字面量出现在 "if"、"for" 或 "switch" 语句块的关键字和左大括号之间,并且复合字面量未用括号、方括号或大括号括起来时,会出现解析歧义。在这种罕见情况下,字面量的左大括号被错误地解析为引入语句块的大括号。为解决此歧义,复合字面量必须出现在括号内。

if x == (T{a,b,c}[i]) { … }
if (x == T{a,b,c}[i]) { … }

有效数组、切片和映射字面量的示例:

// 质数列表
primes := []int{2, 3, 5, 7, 9, 2147483647}

// vowels[ch] 在 ch 是元音时为 true
vowels := [128]bool{'a': true, 'e': true, 'i': true, 'o': true, 'u': true, 'y': true}

// 数组 [10]float32{-1, 0, 0, 0, -0.1, -0.1, 0, 0, 0, -1}
filter := [10]float32{-1, 4: -0.1, -0.1, 9: -1}

// 等音阶频率(A4 = 440Hz)
noteFrequency := map[string]float32{
"C0": 16.35, "D0": 18.35, "E0": 20.60, "F0": 21.83,
"G0": 24.50, "A0": 27.50, "B0": 30.87,
}

函数字面量

函数字面量表示匿名函数。函数字面量不能声明类型参数。

FunctionLit = "func" Signature FunctionBody .
func(a, b int, z float64) bool { return a*b < int(z) }

函数字面量可以赋值给变量或直接调用。

f := func(x, y int) int { return x + y }
func(ch chan int) { ch <- ACK }(replyChan)

函数字面量是_闭包_:它们可以引用周围函数中定义的变量。这些变量在周围函数和函数字面量之间共享,并且只要它们可访问,就会一直存在。

基本表达式

基本表达式是一元和二元表达式的操作数。

PrimaryExpr   = Operand |
                Conversion |
                MethodExpr |
                PrimaryExpr Selector |
                PrimaryExpr Index |
                PrimaryExpr Slice |
                PrimaryExpr TypeAssertion |
                PrimaryExpr Arguments .

Selector      = "." identifier .
Index         = "[" Expression [ "," ] "]" .
Slice         = "[" [ Expression ] ":" [ Expression ] "]" |
                "[" [ Expression ] ":" Expression ":" Expression "]" .
TypeAssertion = "." "(" Type ")" .
Arguments     = "(" [ ( ExpressionList | Type [ "," ExpressionList ] ) [ "..." ] [ "," ] ] ")" .
x
2
(s + ".txt")
f(3.1415, true)
Point{1, 2}
m["foo"]
s[i : j + 1]
obj.color
f.p[i].x()

选择器

对于不是包名基本表达式 x选择器表达式

x.f

表示值 x(或有时是 *x;见下文)的字段或方法 f。标识符 f 称为(字段或方法)选择器;它不能是空标识符。选择器表达式的类型是 f 的类型。如果 x 是包名,请参阅限定标识符部分。

选择器 f 可以表示类型 T 的字段或方法 f,也可以引用 T 的嵌套嵌入字段的字段或方法 f。为到达 f 而遍历的嵌入字段的数量称为其在 T 中的_深度_。在 T 中声明的字段或方法 f 的深度为零。在 T 的嵌入字段 A 中声明的字段或方法 f 的深度是 fA 中的深度加一。

选择器适用以下规则:

  1. 对于类型为 T*T 的值 x,其中 T 不是指针或接口类型,x.f 表示 T 中深度最浅的字段或方法。如果深度最浅的 f 没有唯一一个,则选择器表达式非法。
  2. 对于类型为 I 的值 x,其中 I 是接口类型,x.f 表示 x 的动态值的名为 f 的实际方法。如果 I方法集中没有名为 f 的方法,则选择器表达式非法。
  3. 作为例外,如果 x 的类型是定义的指针类型,且 (*x).f 是表示字段(但不是方法)的有效选择器表达式,则 x.f(*x).f 的简写。
  4. 在所有其他情况下,x.f 非法。
  5. 如果 x 是指针类型且值为 nil,且 x.f 表示结构体字段,则赋值或求值 x.f 会导致运行时恐慌
  6. 如果 x 是接口类型且值为 nil,则调用求值方法 x.f 会导致运行时恐慌

例如,给定声明:

type T0 struct {
x int
}

func (*T0) M0()

type T1 struct {
y int
}

func (T1) M1()

type T2 struct {
z int
T1
*T0
}

func (*T2) M2()

type Q *T2

var t T2     // 且 t.T0 != nil
var p *T2    // 且 p != nil 且 (*p).T0 != nil
var q Q = p

可以编写:

t.z          // t.z
t.y          // t.T1.y
t.x          // (*t.T0).x

p.z          // (*p).z
p.y          // (*p).T1.y
p.x          // (*(*p).T0).x

q.x          // (*(*q).T0).x        (*q).x 是有效的字段选择器

p.M0()       // ((*p).T0).M0()      M0 需要 *T0 接收者
p.M1()       // ((*p).T1).M1()      M1 需要 T1 接收者
p.M2()       // p.M2()              M2 需要 *T2 接收者
t.M2()       // (&t).M2()           M2 需要 *T2 接收者,参见调用部分

但以下无效:

q.M0()       // (*q).M0 有效但不是字段选择器

方法表达式

如果 M 在类型 T方法集中,则 T.M 是一个函数,可以像普通函数一样调用,参数与 M 相同,但前缀一个额外参数,即方法的接收者。

MethodExpr   = ReceiverType "." MethodName .
ReceiverType = Type .

考虑一个结构体类型 T,有两个方法 Mv(接收者类型为 T)和 Mp(接收者类型为 *T)。

type T struct {
a int
}
func (tv  T) Mv(a int) int         { return 0 }  // 值接收者
func (tp *T) Mp(f float32) float32 { return 1 }  // 指针接收者

var t T

表达式

T.Mv

生成一个等价于 Mv 的函数,但显式接收者作为第一个参数,其签名为

func(tv T, a int) int

该函数可以显式接收者正常调用,因此以下五次调用等价:

t.Mv(7)
T.Mv(t, 7)
(T).Mv(t, 7)
f1 := T.Mv; f1(t, 7)
f2 := (T).Mv; f2(t, 7)

类似地,表达式

(*T).Mp

生成一个表示 Mp 的函数值,签名为

func(tp *T, f float32) float32

对于值接收者的方法,可以派生一个显式指针接收者的函数,因此

(*T).Mv

生成一个表示 Mv 的函数值,签名为

func(tv *T, a int) int

这样的函数通过接收者间接传递值,以作为接收者传递给底层方法;方法不会覆盖函数调用中传递地址的值。

最后一种情况,为指针接收者方法派生值接收者函数,是非法的,因为指针接收者方法不在值类型的方法集中。

从方法派生的函数值使用函数调用语法调用;接收者作为调用的第一个参数提供。即,给定 f := T.Mvff(t, 7) 调用,而非 t.f(7)。要构造绑定接收者的函数,使用函数字面量方法值

从接口类型的方法派生函数值是合法的。结果函数显式接收该接口类型。

方法值

如果表达式 x 具有静态类型 T,且 M 在类型 T方法集中,则 x.M 称为_方法值_。方法值 x.M 是一个函数值,可以像 x.M 的方法调用一样使用相同参数调用。表达式 x 在方法值求值期间被求值并保存;保存的副本随后作为接收者用于任何调用,调用可能在之后执行。

type S struct { *T }
type T int
func (t T) M() { print(t) }

t := new(T)
s := S{T: t}
f := t.M                    // 接收者 *t 被求值并存储在 f 中
g := s.M                    // 接收者 *(s.T) 被求值并存储在 g 中
*t = 42                     // 不影响 f 和 g 中存储的接收者

类型 T 可以是接口或非接口类型。

方法表达式讨论中所述,考虑一个结构体类型 T,有两个方法 Mv(接收者类型为 T)和 Mp(接收者类型为 *T)。

type T struct {
a int
}
func (tv  T) Mv(a int) int         { return 0 }  // 值接收者
func (tp *T) Mp(f float32) float32 { return 1 }  // 指针接收者

var t T
var pt *T
func makeT() T

表达式

t.Mv

生成一个类型为

func(int) int

的函数值。以下两次调用等价:

t.Mv(7)
f := t.Mv; f(7)

类似地,表达式

pt.Mp

生成一个类型为

func(float32) float32

的函数值。

选择器类似,使用指针引用值接收者的非接口方法会自动解引用该指针:pt.Mv 等价于 (*pt).Mv

方法调用类似,使用可寻址值引用指针接收者的非接口方法会自动取该值的地址:t.Mp 等价于 (&t).Mp

f := t.Mv; f(7)   // 类似 t.Mv(7)
f := pt.Mp; f(7)  // 类似 pt.Mp(7)
f := pt.Mv; f(7)  // 类似 (*pt).Mv(7)
f := t.Mp; f(7)   // 类似 (&t).Mp(7)
f := makeT().Mp   // 无效: makeT() 的结果不可寻址

尽管上述示例使用非接口类型,但从接口类型的值创建方法值也是合法的。

var i interface { M(int) } = myVal
f := i.M; f(7)  // 类似 i.M(7)

索引表达式

形如

a[x]

的基本表达式表示由 x 索引的数组、指向数组的指针、切片、字符串或映射 a 的元素。值 x 分别称为_索引_或_映射键_。适用以下规则:

如果 a 不是映射也不是类型参数

  • 索引 x 必须是无类型常量,或其类型必须是整数或类型参数(其类型集合仅包含整数类型)
  • 常量索引必须非负且可表示int 类型的值
  • 无类型常量索引将赋予类型 int
  • 索引 x0 <= x < len(a) 范围内为_在范围内_,否则为_超出范围_

对于数组类型 Aa

  • 常量索引必须在范围内
  • 如果 x 在运行时超出范围,发生运行时恐慌
  • a[x] 是指索引 x 的数组元素,其类型为 A 的元素类型

对于指向数组类型的指针a

  • a[x](*a)[x] 的简写

对于切片类型 Sa

  • 如果 x 在运行时超出范围,发生运行时恐慌
  • a[x] 是指索引 x 的切片元素,其类型为 S 的元素类型

对于字符串类型a

  • 如果字符串 a 也是常量,则常量索引必须在范围内
  • 如果 x 在运行时超出范围,发生运行时恐慌
  • a[x] 是指索引 x 的非常量字节值,其类型为 byte
  • a[x] 不能被赋值

对于映射类型 Ma

  • x 的类型必须可赋值M 的键类型
  • 如果映射包含键为 x 的条目,a[x] 是键为 x 的映射元素,其类型为 M 的元素类型
  • 如果映射为 nil 或不包含此类条目,a[x]M 元素类型的零值

对于类型参数类型 Pa

  • 索引表达式 a[x] 必须对 P 类型集合中所有类型的值有效。
  • P 类型集合中所有类型的元素类型必须相同。在此上下文中,字符串类型的元素类型是 byte
  • 如果 P 的类型集合中有映射类型,则该类型集合中的所有类型必须都是映射类型,且相应的键类型必须全部相同。
  • a[x] 是指索引 x 的数组、切片或字符串元素,或键为 x 的映射元素,其类型为 P 实例化时的(相同)元素类型。
  • 如果 P 的类型集合包含字符串类型,则 a[x] 不能被赋值。

否则 a[x] 非法。

赋值语句或特殊形式初始化中使用的映射 a(类型为 map [K]V)的索引表达式

v, ok = a[x]
v, ok := a[x]
var v, ok = a[x]

会生成一个额外的无类型布尔值。如果键 x 存在于映射中,oktrue,否则为 false

nil 映射的元素赋值会导致运行时恐慌

切片表达式

切片表达式从字符串、数组、指向数组的指针或切片操作数构造子字符串或切片。有两种变体:指定上下界的基本形式,以及还指定容量界限的完整形式。

如果操作数类型是类型参数,除非其类型集合包含字符串类型,否则类型集合中的所有类型必须具有相同的底层类型,且切片表达式必须对那种类型的操作数有效。如果类型集合包含字符串类型,它也可以包含底层类型为 []byte 的字节切片。此时,切片表达式必须对 string 类型的操作数有效。

基本切片表达式

对于字符串、数组、指向数组的指针或切片 a,基本表达式

a[low : high]

构造子字符串或切片。索引 lowhigh 选择操作数 a 中出现在结果中的元素。结果从索引 0 开始,长度等于 high - low。对数组 a 切片后

a := [5]int{1, 2, 3, 4, 5}
s := a[1:4]

切片 s 具有类型 []int,长度 3,容量 4,元素为

s[0] == 2
s[1] == 3
s[2] == 4

为方便起见,可以省略任意索引。缺失的 low 索引默认为 0;缺失的 high 索引默认为切片操作数的长度:

a[2:]  // 等同于 a[2 : len(a)]
a[:3]  // 等同于 a[0 : 3]
a[:]   // 等同于 a[0 : len(a)]

如果 a 是指向数组的指针,a[low : high](*a)[low : high] 的简写。

对于数组或字符串,索引在 0 <= low <= high <= len(a) 范围内为_在范围内_,否则为_超出范围_。对于切片,上界是切片容量 cap(a) 而非长度。常量索引必须非负且可表示int 类型的值;对于数组或常量字符串,常量索引也必须在范围内。如果两个索引都是常量,必须满足 low <= high。如果索引在运行时超出范围,发生运行时恐慌

除了无类型字符串,如果切片操作数是字符串或切片,切片操作的结果是操作数类型的非常量值。对于无类型字符串操作数,结果是 string 类型的非常量值。如果切片操作数是数组,它必须是可寻址的,且切片操作的结果是数组元素类型的切片。

如果有效切片表达式的切片操作数是 nil 切片,结果是 nil 切片。否则,如果结果是切片,它与操作数共享底层数组。

var a [10]int
s1 := a[3:7]   // s1 的底层数组是数组 a; &s1[2] == &a[5]
s2 := s1[1:4]  // s2 的底层数组是 s1 的底层数组即数组 a; &s2[1] == &a[5]
s2[1] = 42     // s2[1] == s1[2] == a[5] == 42; 它们都引用同一底层数组元素

var s []int
s3 := s[:0]    // s3 == nil

完整切片表达式

对于数组、指向数组的指针或切片 a(但非字符串),基本表达式

a[low : high : max]

构造与基本切片表达式 a[low : high] 类型相同、长度和元素相同的切片。此外,它通过设置 max - low 控制结果切片的容量。只能省略第一个索引;它默认为 0。对数组 a 切片后

a := [5]int{1, 2, 3, 4, 5}
t := a[1:3:5]

切片 t 具有类型 []int,长度 2,容量 4,元素为

t[0] == 2
t[1] == 3

对于基本切片表达式,如果 a 是指向数组的指针,a[low : high : max](*a)[low : high : max] 的简写。如果切片操作数是数组,它必须是可寻址的

索引在 0 <= low <= high <= max <= cap(a) 范围内为_在范围内_,否则为_超出范围_。常量索引必须非负且可表示int 类型的值;对于数组,常量索引也必须在范围内。如果多个索引是常量,存在的常量必须彼此在范围内。如果索引在运行时超出范围,发生运行时恐慌

类型断言

对于接口类型(但不是类型参数)的表达式 x 和类型 T,基本表达式

x.(T)

断言 x 不为 nilx 中存储的值类型为 T。记号 x.(T) 称为_类型断言_。

更精确地说,如果 T 不是接口类型,x.(T) 断言 x 的动态类型与类型 T 相同。此时,T 必须实现 x 的(接口)类型;否则类型断言无效,因为 x 不可能存储 T 类型的值。如果 T 是接口类型,x.(T) 断言 x 的动态类型实现接口 T

如果类型断言成立,表达式的值是 x 中存储的值,其类型为 T。如果类型断言为假,发生运行时恐慌。换句话说,即使 x 的动态类型仅在运行时可知,x.(T) 的类型在正确程序中已知为 T

var x interface{} = 7          // x 具有动态类型 int 和值 7
i := x.(int)                   // i 具有类型 int 和值 7

type I interface { m() }

func f(y I) {
s := y.(string)        // 非法: string 未实现 I(缺少方法 m)
r := y.(io.Reader)     // r 具有类型 io.Reader 且 y 的动态类型必须同时实现 I 和 io.Reader

}

赋值语句或特殊形式初始化中使用的类型断言

v, ok = x.(T)
v, ok := x.(T)
var v, ok = x.(T)
var v, ok interface{} = x.(T) // v 和 ok 的动态类型分别是 T 和 bool

会生成一个额外的无类型布尔值。如果断言成立,ok 的值为 true;否则为 false,且 v 的值为类型 T零值。在这种情况下,不会发生运行时恐慌

调用

给定一个函数类型 F 的表达式 f

f(a1, a2, … an)

用参数 a1, a2, … an 调用 f。除一个特殊情况外,参数必须是可赋值F 的参数类型的单值表达式,并在函数调用前求值。表达式的类型是 F 的结果类型。方法调用类似,但方法本身指定为方法接收者类型值上的选择器。

math.Atan2(x, y)  // 函数调用
var pt *Point
pt.Scale(3.5)     // 使用接收者 pt 的方法调用

如果 f 表示泛型函数,则必须实例化后才能调用或用作函数值。

如果 f 的类型是类型参数,其类型集合中的所有类型必须具有相同的底层类型,且必须是函数类型,函数调用必须对那种类型有效。

在函数调用中,函数值和参数按常规顺序求值。求值后,为函数的变量(包括参数和结果)分配新存储。然后,调用参数被_传递_给函数,这意味着它们被赋值给相应的函数参数,被调函数开始执行。函数返回时,返回参数传回调用者。

调用 nil 函数值会导致运行时恐慌

作为特殊情况,如果函数或方法 g 的返回值数量与另一个函数或方法 f 的参数数量相同,且可单独赋值给 f 的参数,则调用 f(g(_parameters_of_g_)) 会将 g 的返回值按顺序传递给 f 的参数后调用 ff 的调用除 g 的调用外不能有其他参数,且 g 必须至少有一个返回值。如果 f 有最终的 ... 参数,它将被分配 g 的常规参数赋值后剩余的返回值。

func Split(s string, pos int) (string, string) {
return s[0:pos], s[pos:]
}

func Join(s, t string) string {
return s + t
}

if Join(Split(value, len(value)/2)) != value {
log.Panic("test fails")
}

方法调用 x.m() 在(x 的类型的)方法集包含 m 且参数列表可赋值给 m 的参数列表时有效。如果 x可寻址的&x 的方法集包含 m,则 x.m()(&x).m() 的简写:

var p Point
p.Sale(3.5)

没有独立的方法类型,也没有方法字面量。

... 参数传递参数

如果 f可变参数且最终参数 p 的类型为 ...T,则 f 内部 p 的类型等价于 []T。如果 f 调用时没有为 p 提供实际参数,传递给 p 的值是 nil。否则,传递的值是类型 []T 的新切片,具有新底层数组,其连续元素为实际参数(都必须可赋值T)。因此切片的长度和容量是绑定到 p 的参数数量,每次调用可能不同。

给定函数和调用

func Greeting(prefix string, who ...string)
Greeting("nobody")
Greeting("hello:", "Joe", "Anna", "Eileen")

Greeting 内,who 在第一次调用时为 nil,第二次调用时为 []string{"Joe", "Anna", "Eileen"}

如果最终参数可赋值给切片类型 []T 且后跟 ...,它将原样作为 ...T 参数的值传递。此时不创建新切片。

给定切片 s 和调用

s := []string{"James", "Jasmine"}
Greeting("goodbye:", s...)

Greeting 内,who 将与 s 具有相同值和底层数组。

实例化

泛型函数或类型通过将_类型参数_替换为_类型实参_来_实例化_ [Go 1.18]。实例化分两步:

  1. 每个类型实参替换泛型声明中对应的类型参数。替换发生在整个函数或类型声明中,包括类型参数列表本身及列表中的任何类型。
  2. 替换后,每个类型实参必须满足对应类型参数的约束(必要时实例化)。否则实例化失败。

实例化类型产生新的非泛型命名类型;实例化函数产生新的非泛型函数。

类型参数列表        类型实参        替换后

[P any]            int            int 满足 any
[S ~[]E, E any]    []int, int     []int 满足 ~[]int, int 满足 any
[P io.Writer]      string         非法: string 不满足 io.Writer
[P comparable]     any            any 满足 (但不实现) comparable

使用泛型函数时,类型实参可以显式提供,也可以部分或完全从使用函数的上下文中推断。只要可推断,如果函数:

则可以完全省略类型实参列表。

在所有其他情况下,必须提供(可能部分)类型实参列表。如果类型实参列表缺失或部分,所有缺失的类型实参必须能从使用函数的上下文中推断。

// sum 返回参数的和(字符串则为连接)
func sum[T ~int | ~float64 | ~string](x... T) T { … }

x := sum                       // 非法: x 的类型未知
intSum := sum[int]             // intSum 类型为 func(x... int) int
a := intSum(2, 3)              // a 值为 5,类型为 int
b := sum[float64](2.0, 3)      // b 值为 5.0,类型为 float64
c := sum(b, -1)                // c 值为 4.0,类型为 float64

type sumFunc func(x... string) string
var f sumFunc = sum            // 同 var f sumFunc = sum[string]
f = sum                        // 同 f = sum[string]

部分类型实参列表不能为空;至少第一个实参必须存在。列表是完整类型实参列表的前缀,剩余实参待推断。通俗地说,类型实参可从"右到左"省略。

func apply[S ~[]E, E any](s S, f func(E) E) S { … }

f0 := apply[]                  // 非法: 类型实参列表不能为空
f1 := apply[[]int]             // S 的类型实参显式提供,E 的类型实参推断
f2 := apply[[]string, string]  // 两个类型实参均显式提供

var bytes []byte
r := apply(bytes, func(byte) byte { … })  // 两个类型实参从函数参数推断

对于泛型类型,所有类型实参必须始终显式提供。

类型推断

泛型函数的使用中,如果类型实参能从使用函数的上下文中_推断_(包括函数类型参数的约束),则可以省略部分或全部类型实参。如果可推断缺失的类型实参且实例化在推断的类型实参下成功,则类型推断成功;否则类型推断失败,程序无效。

类型推断利用成对类型间的类型关系进行推断:例如,函数参数必须可赋值给对应的函数参数;这建立了参数类型与参数类型的关系。如果这两个类型之一包含类型参数,类型推断会寻找替换类型参数的实参,使可赋值关系成立。类似地,类型推断利用类型实参必须满足对应类型参数约束的事实。

每对匹配类型对应一个包含一个或多个类型参数的_类型方程_(可能来自多个泛型函数)。推断缺失类型实参意味着求解所得类型方程组对相应类型参数的值。

例如,给定

// dedup 返回参数切片的副本,删除任何重复条目
func dedup[S ~[]E, E comparable](S) S { … }

type Slice []int
var s Slice
s = dedup(s)   // 同 s = dedup[Slice, int](s)

程序有效时,类型 Slice 的变量 s 必须可赋值给函数参数类型 S。为降低复杂性,类型推断忽略赋值方向性,因此 SliceS 的类型关系可表示为(对称的)类型方程 Slice ≡<sub>A</sub> S(或 S ≡<sub>A</sub> Slice),其中 ≡<sub>A</sub> 中的 <sub>A</sub> 表示左右类型必须按可赋值规则匹配(详见类型统一部分)。类似地,类型参数 S 必须满足约束 ~[]E。这可表示为 S ≡<sub>C</sub> ~[]E,其中 X ≡<sub>C</sub> Y 表示 "X 满足约束 Y"。这些观察导致两个方程

Slice ≡A S      (1)
S     ≡C ~[]E   (2)

现在可求解类型参数 SE。由 (1) 编译器可推断 S 的类型实参是 Slice。类似地,因为 Slice 的底层类型是 []int[]int 必须匹配约束中的 []E,编译器可推断 E 必须是 int。因此,对这两个方程,类型推断得出

S ➞ Slice
E ➞ int

给定类型方程组,待求解的类型参数是需要实例化且未提供显式类型实参的函数的类型参数。这些类型参数称为_绑定_类型参数。例如,在 dedup 示例中,类型参数 SE 绑定到 dedup。泛型函数调用的参数可以是泛型函数本身。该函数的类型参数包含在绑定类型参数集合中。函数参数的类型可能包含其他函数的类型参数(如包含函数调用的泛型函数)。这些类型参数可能出现在类型方程中,但在该上下文中不绑定。类型方程始终只针对绑定类型参数求解。

类型推断支持泛型函数调用和泛型函数赋值给(显式函数类型的)变量。这包括将泛型函数作为参数传递给其他(可能也是泛型的)函数,以及将泛型函数作为结果返回。类型推断对每种情况的特定方程组操作。方程如下(为清晰省略类型实参列表):

  • 对函数调用 f(a<sub>0</sub>, a<sub>1</sub>, …),其中 f 或函数参数 a<sub>i</sub> 是泛型函数:
    每对对应的函数参数 (a<sub>i</sub>, p<sub>i</sub>)(其中 a<sub>i</sub> 不是无类型常量)生成方程 typeof(p<sub>i</sub>) ≡<sub>A</sub> typeof(a<sub>i</sub>)
    如果 a<sub>i</sub> 是无类型常量 c<sub>j</sub>typeof(p<sub>i</sub>) 是绑定类型参数 P<sub>k</sub>,则对 (c<sub>j</sub>, P<sub>k</sub>) 单独收集,不纳入类型方程。

  • 对泛型函数 f 赋值给函数类型(非泛型)变量 vv = f
    typeof(v) ≡<sub>A</sub> typeof(f)

  • 对返回语句 return …, f, …,其中 f 是泛型函数作为结果返回给函数类型(非泛型)结果变量 r
    typeof(r) ≡<sub>A</sub> typeof(f)

此外,每个类型参数 P<sub>k</sub> 和对应约束 C<sub>k</sub> 生成类型方程 P<sub>k</sub> ≡<sub>C</sub> C<sub>k</sub>

类型推断优先处理从类型操作数获得的信息,再考虑无类型常量。因此推断分两个阶段:

  1. 使用类型统一求解类型方程对绑定类型参数的值。如果统一失败,类型推断失败。

  2. 对每个尚未推断类型实参且收集到一个或多个对 (c<sub>j</sub>, P<sub>k</sub>) 的绑定类型参数 P<sub>k</sub>,确定所有对中常量 c<sub>j</sub>常量种类(方法与常量表达式相同)。P<sub>k</sub> 的类型实参是确定常量种类的默认类型。如果因冲突常量种类无法确定常量种类,类型推断失败。

如果两阶段后未找到所有类型实参,类型推断失败。

如果两阶段成功,类型推断为每个绑定类型参数确定类型实参:

Pk ➞ Ak

类型实参 A<sub>k</sub> 可以是复合类型,包含其他绑定类型参数 P<sub>k</sub> 作为元素类型(或仅为另一个绑定类型参数)。在重复简化过程中,每个类型实参中的绑定类型参数替换为对应类型实参,直到每个类型实参不含绑定类型参数。

如果类型实参通过绑定类型参数包含对自身的循环引用,简化及类型推断失败。否则,类型推断成功。

类型统一

类型推断通过_类型统一_求解类型方程。类型统一递归比较方程的左右类型(任一或两者可能是或包含绑定类型参数),寻找这些类型参数的实参,使左右类型匹配(根据上下文完全相同或可赋值兼容)。为此,类型推断维护绑定类型参数到推断类型实参的映射;该映射在类型统一过程中查询和更新。初始时,绑定类型参数已知但映射为空。类型统一过程中,如果推断新类型实参 A,则将类型参数到实参的映射 P ➞ A 添加到映射。相反,比较类型时,已知类型实参(已有映射条目的类型实参)取代对应类型参数。随着类型推断进行,映射逐渐填充,直到考虑所有方程或统一失败。如果无统一步骤失败且映射有每个类型参数的条目,则类型推断成功。

例如,给定含绑定类型参数 P 的类型方程

[10]struct{ elem P, list []P } ≡A [10]struct{ elem string; list []string }

类型推断从空映射开始。统一首先比较左右类型的顶层结构。两者都是相同长度的数组;如果元素类型统一,则它们统一。两个元素类型都是结构体;如果字段数量、名称相同且字段类型统一,则它们统一。P 的类型实参尚不知(无映射条目),因此统一 Pstring 将映射 P ➞ string 添加到映射。统一 list 字段类型需要统一 []P[]string,从而统一 Pstring。由于此时 P 的类型实参已知(有 P 的映射条目),其类型实参 string 取代 P。由于 stringstring 相同,此统一步骤也成功。方程左右类型的统一现在完成。由于只有一个类型方程,无统一步骤失败且映射完全填充,类型推断成功。

统一根据两种类型必须相同可赋值兼容或仅结构相等,组合使用_精确_和_宽松_统一。详细的类型统一规则附录中说明。

对于形如 X ≡<sub>A</sub> Y 的方程(其中 XY 是涉及赋值(包括参数传递和返回语句)的类型),顶层类型结构可宽松统一,但元素类型必须精确统一,匹配赋值规则。

对于形如 P ≡<sub>C</sub> C 的方程(其中 P 是类型参数,C 是其对应约束),统一规则更复杂:

  • 如果 C 的类型集合中所有类型有相同底层类型 U,且 P 有已知类型实参 A,则 UA 必须宽松统一。
  • 类似地,如果 C 的类型集合中所有类型是相同元素类型且无冲突通道方向的通道类型,且 P 有已知类型实参 A,则 C 的类型集合中最严格的通道类型与 A 必须宽松统一。
  • 如果 P 无已知类型实参且 C 恰好包含一个不是底层(波浪线)类型的类型项 T,则统一将映射 P ➞ T 添加到映射。
  • 如果 C 无上述类型 UP 有已知类型实参 A,则 A 必须具有 C 的所有方法(如果有),且对应方法类型必须精确统一。

求解类型约束的类型方程时,求解一个方程可能推断额外类型实参,这些实参可能使依赖它们的方程可求解。只要推断新类型实参,类型推断就重复类型统一。

运算符

运算符将操作数组合成表达式。

Expression = UnaryExpr | Expression binary_op Expression .
UnaryExpr  = PrimaryExpr | unary_op UnaryExpr .

binary_op  = "||" | "&&" | rel_op | add_op | mul_op .
rel_op     = "==" | "!=" | "<" | "<=" | ">" | ">=" .
add_op     = "+" | "-" | "|" | "^" .
mul_op     = "*" | "/" | "%" | "<<" | ">>" | "&" | "&^" .

unary_op   = "+" | "-" | "!" | "^" | "*" | "&" | "<-" .

比较运算在其他部分讨论。对于其他二元运算符,除非运算涉及移位或无类型常量,否则操作数类型必须相同。仅涉及常量的运算,参见常量表达式部分。

除了移位运算,如果一个操作数是无类型常量而另一个不是,常量将隐式转换为另一个操作数的类型。

移位表达式中的右操作数必须具有整数类型 [Go 1.13],或为可表示uint 类型值的无类型常量。如果非常量移位表达式的左操作数是无类型常量,它将首先隐式转换为移位表达式被其左操作数单独替换时所采用的类型。

var a [1024]byte
var s uint = 33

// 以下示例的结果基于 64 位整数。
var i = 1<<s                   // 1 具有类型 int
var j int32 = 1<<s             // 1 具有类型 int32; j == 0
var k = uint64(1<<s)           // 1 具有类型 uint64; k == 1<<33
var m int = 1.0<<s             // 1.0 具有类型 int; m == 1<<33
var n = 1.0<<s == j            // 1.0 具有类型 int32; n == true
var o = 1<<s == 2<<s           // 1 和 2 具有类型 int; o == false
var p = 1<<s == 1<<33          // 1 具有类型 int; p == true
var u = 1.0<<s                 // 非法: 1.0 具有类型 float64,不能移位
var u1 = 1.0<<s != 0           // 非法: 1.0 具有类型 float64,不能移位
var u2 = 1<<s != 1.0           // 非法: 1 具有类型 float64,不能移位
var v1 float32 = 1<<s          // 非法: 1 具有类型 float32,不能移位
var v2 = string(1<<s)          // 非法: 1 转换为字符串,不能移位
var w int64 = 1.0<<33          // 1.0<<33 是常量移位表达式; w == 1<<33
var x = a[1.0<<s]              // panic: 1.0 具有类型 int,但 1<<33 溢出数组边界
var b = make([]byte, 1.0<<s)   // 1.0 具有类型 int; len(b) == 1<<33

// 以下示例的结果基于 32 位整数,
// 这意味着移位将溢出。
var mm int = 1.0<<s            // 1.0 具有类型 int; mm == 0
var oo = 1<<s == 2<<s          // 1 和 2 具有类型 int; oo == true
var pp = 1<<s == 1<<33         // 非法: 1 具有类型 int,但 1<<33 溢出 int
var xx = a[1.0<<s]             // 1.0 具有类型 int; xx == a[0]
var bb = make([]byte, 1.0<<s)  // 1.0 具有类型 int; len(bb) == 0

运算符优先级

一元运算符具有最高优先级。由于 ++-- 运算符形成语句而非表达式,它们不属于运算符层次结构。因此,语句 *p++ 等同于 (*p)++

二元运算符有五个优先级等级。乘法运算符绑定最强,其次是加法运算符、比较运算符、&&(逻辑与),最后是 ||(逻辑或):

优先级    运算符
    5             *  /  %  <<  >>  &  &^
    4             +  -  |  ^
    3             ==  !=  <  <=  >  >=
    2             &&
    1             ||

相同优先级的二元运算符从左到右结合。例如,x / y * z 等同于 (x / y) * z

+x                         // x
42 + a - b                 // (42 + a) - b
23 + 3*x[i]                // 23 + (3 * x[i])
x <= f()                   // x <= f()
^a >> b                    // (^a) >> b
f() || g()                 // f() || g()
x == y+1 && <-chanInt > 0  // (x == (y+1)) && ((<-chanInt) > 0)

算术运算符

算术运算符应用于数值并产生与第一个操作数相同类型的结果。四种标准算术运算符(+, -, *, /)适用于整数浮点数复数类型;+ 也适用于字符串。位逻辑和移位运算符仅适用于整数。

+    和                     整数、浮点数、复数、字符串
-    差                     整数、浮点数、复数
*    积                     整数、浮点数、复数
/    商                     整数、浮点数、复数
%    余数                   整数

&    位与                   整数
|    位或                   整数
^    位异或                 整数
&^   位清除(与非)         整数

<<   左移                   整数 << 整数 >= 0
>>   右移                   整数 >> 整数 >= 0

如果操作数类型是类型参数,运算符必须适用于该类型集合中的每种类型。操作数表示为类型参数实例化时的类型实参值,运算以该类型实参的精度计算。例如,给定函数:

func dotProduct[F ~float32|~float64](v1, v2 []F) F {
var s F
for i, x := range v1 {
y := v2[i]
s += x * y
}
return s
}

乘积 x * y 和加法 s += x * y 分别以 float32float64 精度计算,取决于 F 的类型实参。

整数运算符

对于两个整数值 xy,整数商 q = x / y 和余数 r = x % y 满足以下关系:

x = q*y + r  且  |r| < |y|

其中 x / y 向零截断("截断除法")。

 x     y     x / y     x % y
 5     3       1         2
-5     3      -1        -2
 5    -3      -1         2
-5    -3       1        -2

此规则的唯一例外是当被除数 xx 的整数类型的最小负值时,商 q = x / -1 等于 x(且 r = 0),这是由于二进制补码整数溢出

                         x, q
int8                     -128
int16                  -32768
int32             -2147483648
int64    -9223372036854775808

如果除数是常量,它必须不为零。如果除数在运行时为零,发生运行时恐慌。如果被除数非负且除数是 2 的常数次幂,除法可用右移替代,计算余数可用位与操作替代:

 x     x / 4     x % 4     x >> 2     x & 3
 11      2         3         2          3
-11     -2        -3        -3          1

移位运算符将左操作数按右操作数指定的移位计数移位,右操作数必须非负。如果移位计数在运行时为负,发生运行时恐慌。如果左操作数是有符号整数,移位运算符实现算术移位;如果是无符号整数,实现逻辑移位。移位计数无上界。移位行为如同左操作数按移位计数 n 次每次移 1 位。因此,x << 1 等同于 x*2x >> 1 等同于 x/2 但向负无穷截断。

对于整数操作数,一元运算符 +, -, 和 ^ 定义如下:

+x                          是 0 + x
-x    取负                  是 0 - x
^x    位补码                是 m ^ x,其中 m = "全位设为 1"(无符号 x)
                                      且 m = -1(有符号 x)

整数溢出

对于无符号整数值,运算 +, -, *, 和 << 按模 2n 计算,其中 n 是无符号整数类型的位宽。通俗地说,这些无符号整数运算在溢出时丢弃高位,程序可依赖"回绕"行为。

对于有符号整数,运算 +, -, *, /, 和 << 可能合法溢出,结果值由有符号整数表示、运算及其操作数确定性定义。溢出不会导致运行时恐慌。编译器不能假设溢出不会发生来优化代码。例如,不能假设 x < x + 1 始终为真。

浮点运算符

对于浮点数和复数,+x 等同于 x,而 -xx 的取负。浮点或复数除以零的结果超出 IEEE 754 标准未指定;是否发生运行时恐慌取决于实现。

实现可将多个浮点运算合并为单个融合运算(可能跨语句),产生与单独执行并舍入指令获得值不同的结果。显式浮点类型转换舍入到目标类型精度,防止丢弃该舍入的融合。

例如,某些架构提供"融合乘加"(FMA)指令,计算 x*y + z 时不舍入中间结果 x*y。以下示例显示 Go 实现何时可使用该指令:

// 允许 FMA 计算 r,因为 x*y 未显式舍入:
r  = x*y + z
r  = z;   r += x*y
t  = x*y; r = t + z
*p = x*y; r = *p + z
r  = x*y + float64(z)

// 禁止 FMA 计算 r,因为它会省略 x*y 的舍入:
r  = float64(x*y) + z
r  = z; r += float64(x*y)
t  = float64(x*y); r = t + z

字符串连接

字符串可用 + 运算符或 += 赋值运算符连接:

s := "hi" + string(c)
s += " and good bye"

字符串加法通过连接操作数创建新字符串。

比较运算符

比较运算符比较两个操作数并产生无类型布尔值。

==    等于
!=    不等于
<     小于
<=    小于或等于
>     大于
>=    大于或等于

任何比较中,第一个操作数必须可赋值给第二个操作数的类型,或反之。

相等运算符 ==!= 适用于_可比较_类型的操作数。排序运算符 &lt;, &lt;=, &gt;, 和 &lt;= 适用于_有序_类型的操作数。这些术语和比较结果定义如下:

  • 布尔类型可比较。两个布尔值相等当且仅当它们同为 true 或同为 false
  • 整数类型可比较且有序。两个整数值按通常方式比较。
  • 浮点类型可比较且有序。两个浮点值按 IEEE 754 标准定义比较。
  • 复数类型可比较。两个复数 uv 相等当且仅当 real(u) == real(v)imag(u) == imag(v)
  • 字符串类型可比较且有序。两个字符串值按字典序逐字节比较。
  • 指针类型可比较。两个指针值相等当且仅当它们指向同一变量或值均为 nil。指向不同零大小变量的指针可能相等也可能不相等。
  • 通道类型可比较。两个通道值相等当且仅当它们由同一 make 调用创建或值均为 nil
  • 非类型参数的接口类型可比较。两个接口值相等当且仅当它们具有相同动态类型且动态值相等,或值均为 nil
  • 非接口类型 X 的值 x 和接口类型 T 的值 t 可比较,如果类型 X 可比较且 X 实现 T。它们相等当且仅当 t 的动态类型与 X 相同且 t 的动态值等于 x
  • 结构体类型可比较当且仅当所有字段类型可比较。两个结构体值相等当且仅当对应非字段值相等。字段按源码顺序比较,一旦两个字段值不同即停止比较(或比较完所有字段)。
  • 数组类型可比较当且仅当数组元素类型可比较。两个数组值相等当且仅当对应元素值相等。元素按升序索引顺序比较,一旦两个元素值不同即停止比较(或比较完所有元素)。
  • 类型参数可比较当且仅当它们严格可比较(见下文)。

比较两个动态类型相同的接口值在类型不可比较时导致运行时恐慌。此行为不仅适用于直接接口值比较,也适用于比较接口值数组或含接口值字段的结构体。

切片、映射和函数类型不可比较。但作为特殊情况,切片、映射或函数值可与预声明标识符 nil 比较。指针、通道和接口值与 nil 的比较也允许,遵循上述通用规则。

const c = 3 < 4            // c 是无类型布尔常量 true

type MyBool bool
var x, y int
var (
// 比较结果是布尔值。
// 适用通常赋值规则。
b3        = x == y // b3 具有类型 bool
b4 bool   = x == y // b4 具有类型 bool
b5 MyBool = x == y // b5 具有类型 MyBool
)

类型_严格可比较_当且仅当它可比较且不是接口类型也不由接口类型组成。具体:

  • 布尔、数值、字符串、指针和通道类型严格可比较。
  • 结构体类型严格可比较当且仅当所有字段类型严格可比较。
  • 数组类型严格可比较当且仅当数组元素类型严格可比较。
  • 类型参数严格可比较当且仅当类型集合中所有类型严格可比较。

逻辑运算符

逻辑运算符应用于布尔值并产生与操作数相同类型的结果。先求值左操作数,然后根据条件需要求值右操作数。

&&    条件与    p && q  是  "如果 p 则 q 否则 false"
||    条件或    p || q  是  "如果 p 则 true 否则 q"
!     非        !p      是  "非 p"

地址运算符

对于类型 T 的操作数 x,地址运算 &x 生成指向 x 的类型 *T 的指针。操作数必须_可寻址_,即变量、指针间接或切片索引操作;或可寻址结构体操作数的字段选择器;或可寻址数组的数组索引操作。作为地址性要求的例外,x 也可以是(可能带括号的)复合字面量。如果 x 的求值会导致运行时恐慌,则 &x 的求值也会。

对于指针类型 *T 的操作数 x,指针间接 *x 表示 x 指向的类型 T变量。如果 xnil,尝试求值 *x 将导致运行时恐慌

&x
&a[f(2)]
&Point{2, 3}
*p
*pf(x)

var x *int = nil
*x   // 导致运行时恐慌
&*x  // 导致运行时恐慌

接收运算符

对于通道类型的操作数 ch,接收运算 <-ch 的值是从通道 ch 接收的值。通道方向必须允许接收操作,接收运算的类型是通道的元素类型。表达式阻塞直到值可用。从 nil 通道接收永远阻塞。从关闭的通道接收总能立即进行,在接收所有先前发送的值后产生元素类型的零值

v1 := <-ch
v2 = <-ch
f(<-ch)
<-strobe  // 等待时钟脉冲并丢弃接收的值

如果操作数类型是类型参数,其类型集合中所有类型必须是允许接收操作的通道类型,且必须具有相同元素类型(即接收运算的类型)。

赋值语句或特殊形式初始化中使用的接收表达式

x, ok = <-ch
x, ok := <-ch
var x, ok = <-ch
var x, ok T = <-ch

会产生额外的无类型布尔结果,报告通信是否成功。如果接收的值成功发送到通道,oktrue;如果通道关闭且为空产生零值,则为 false

转换

转换将表达式的类型更改为转换指定的类型。转换可能字面出现在源码中,也可能由表达式出现的上下文_隐含_。

_显式_转换是形如 T(x) 的表达式,其中 T 是类型,x 是可为类型 T 转换的表达式。

Conversion = Type "(" Expression [ "," ] ")" .

如果类型以运算符 *<- 开头,或类型以关键字 func 开头且无结果列表,必要时必须加括号以避免歧义:

*Point(p)        // 同 *(Point(p))
(*Point)(p)      // p 转换为 *Point
<-chan int(c)    // 同 <-(chan int(c))
(<-chan int)(c)  // c 转换为 <-chan int
func()(x)        // 函数签名 func() x
(func())(x)      // x 转换为 func()
(func() int)(x)  // x 转换为 func() int
func() int(x)    // x 转换为 func() int (无歧义)

常量x 可转换为类型 T,如果 x 可表示T 的值。作为特殊情况,整数常量 x 可显式转换为字符串类型,使用与非常量 x 相同规则

常量转换为非类型参数类型产生类型化常量。

uint(iota)               // iota 类型 uint 的值
float32(2.718281828)     // 类型 float32 的 2.718281828
complex128(1)            // 类型 complex128 的 1.0 + 0.0i
float32(0.49999999)      // 类型 float32 的 0.5
float64(-1e-1000)        // 类型 float64 的 0.0
string('x')              // 类型 string 的 "x"
string(0x266c)           // 类型 string 的 "♬"
myString("foo" + "bar")  // 类型 myString 的 "foobar"
string([]byte{'a'})      // 非常量: []byte{'a'} 不是常量
(*int)(nil)              // 非常量: nil 不是常量, *int 不是布尔、数值或字符串类型
int(1.2)                 // 非法: 1.2 不能表示为 int
string(65.0)             // 非法: 65.0 不是整数常量

常量转换为类型参数产生该类型的_非常量_值,值表示为类型参数实例化时的类型实参值。例如,给定函数:

func f[P ~float32|~float64]() {
… P(1.1) …
}

转换 P(1.1) 产生类型 P 的非常量值,值 1.1 根据 f 的类型实参表示为 float32float64。因此,如果 ffloat32 类型实例化,表达式 P(1.1) + 1.2 的数值将以对应非常量 float32 加法的相同精度计算。

非常量值 x 可在以下任一情况下转换为类型 T

  • x 可赋值T
  • 忽略结构体标签(见下文),x 的类型和 T 都不是类型参数但有相同底层类型
  • 忽略结构体标签(见下文),x 的类型和 T 都是非命名类型的指针类型,且它们的指针基类型都不是类型参数但有相同底层类型。
  • x 的类型和 T 都是整数或浮点类型。
  • x 的类型和 T 都是复数类型。
  • x 是整数或字节或符文切片,T 是字符串类型。
  • x 是字符串,T 是字节或符文切片。
  • x 是切片,T 是数组 [Go 1.20] 或指向数组的指针 [Go 1.17],且切片和数组类型有相同元素类型。

此外,如果 Tx 的类型 V 是类型参数,x 也可在以下任一条件下转换为类型 T

  • VT 都是类型参数,且 V 类型集合中每种类型的值可转换为 T 类型集合中每种类型。
  • 只有 V 是类型参数,且 V 类型集合中每种类型的值可转换为 T
  • 只有 T 是类型参数,且 x 可转换为 T 类型集合中每种类型。

结构体标签在比较结构体类型以进行转换时忽略:

type Person struct {
Name    string
Address *struct {
Street string
City   string
}
}

var data *struct {
Name    string `json:"name"`
Address *struct {
Street string `json:"street"`
City   string `json:"city"`
} `json:"address"`
}

var person = (*Person)(data)  // 忽略标签,底层类型相同

特定规则适用于数值类型之间或与字符串类型之间的(非常量)转换。这些转换可能更改 x 的表示并产生运行时开销。所有其他转换只更改类型而不更改 x 的表示。

没有语言机制在指针和整数之间转换。包 unsafe 在受限情况下实现此功能。

数值类型之间的转换

对于非常量数值值的转换,适用以下规则:

  1. 整数类型之间转换时,如果值是有符号整数,则符号扩展到隐式无限精度;否则零扩展。然后截断以适合结果类型的大小。例如,如果 v := uint16(0x10F0),则 uint32(int8(v)) == 0xFFFFFFF0。转换始终产生有效值;无溢出指示。
  2. 浮点数转换为整数时,小数部分丢弃(向零截断)。
  3. 将整数或浮点数转换为浮点类型,或将复数转换为另一复数类型时,结果值舍入到目标类型指定的精度。例如,类型 float32 的变量 x 的值可能使用超过 IEEE 754 32 位数的额外精度存储,但 float32(x) 表示将 x 的值舍入到 32 位精度的结果。类似地,x + 0.1 可能使用超过 32 位精度,但 float32(x + 0.1) 不使用。

在所有涉及浮点或复数值的非常量转换中,如果结果类型不能表示该值,转换成功但结果值实现依赖。

与字符串类型之间的转换

  1. 将字节切片转换为字符串类型产生字符串,其连续字节是切片的元素。

    string([]byte{'h', 'e', 'l', 'l', '\xc3', '\xb8'})   // "hellø"
    string([]byte{})                                     // ""
    string([]byte(nil))                                  // ""
    
    type bytes []byte
    string(bytes{'h', 'e', 'l', 'l', '\xc3', '\xb8'})    // "hellø"
    
    type myByte byte
    string([]myByte{'w', 'o', 'r', 'l', 'd', '!'})       // "world!"
    myString([]myByte{'\xf0', '\x9f', '\x8c', '\x8d'})   // "🌍"
    
  2. 将符文切片转换为字符串类型产生字符串,即各个符文值转换为字符串的连接。

    string([]rune{0x767d, 0x9d6c, 0x7fd4})   // "\u767d\u9d6c\u7fd4" == "白鵬翔"
    string([]rune{})                         // ""
    string([]rune(nil))                      // ""
    
    type runes []rune
    string(runes{0x767d, 0x9d6c, 0x7fd4})    // "\u767d\u9d6c\u7fd4" == "白鵬翔"
    
    type myRune rune
    string([]myRune{0x266b, 0x266c})         // "\u266b\u266c" == "♫♬"
    myString([]myRune{0x1f30e})              // "\U0001f30e" == "🌎"
    
  3. 将字符串类型的值转换为字节切片类型产生非 nil 切片,其连续元素是字符串的字节。结果切片的容量实现依赖,可能大于切片长度。

    []byte("hellø")             // []byte{'h', 'e', 'l', 'l', '\xc3', '\xb8'}
    []byte("")                  // []byte{}
    
    bytes("hellø")              // []byte{'h', 'e', 'l', 'l', '\xc3', '\xb8'}
    
    []myByte("world!")          // []myByte{'w', 'o', 'r', 'l', 'd', '!'}
    []myByte(myString("🌏"))    // []myByte{'\xf0', '\x9f', '\x8c', '\x8f'}
    
  4. 将字符串类型的值转换为符文切片类型产生包含字符串各个 Unicode 代码点的切片。结果切片的容量实现依赖,可能大于切片长度。

    []rune(myString("白鵬翔"))   // []rune{0x767d, 0x9d6c, 0x7fd4}
    []rune("")                  // []rune{}
    
    runes("白鵬翔")              // []rune{0x767d, 0x9d6c, 0x7fd4}
    
    []myRune("♫♬")              // []myRune{0x266b, 0x266c}
    []myRune(myString("🌐"))    // []myRune{0x1f310}
    
  5. 最后,出于历史原因,整数值可转换为字符串类型。这种转换产生包含给定整数值的(可能多字节)UTF-8 表示的字符串。超出有效 Unicode 代码点范围的值转换为 "\uFFFD"

    string('a')          // "a"
    string(65)           // "A"
    string('\xf8')       // "\u00f8" == "ø" == "\xc3\xb8"
    string(-1)           // "\ufffd" == "\xef\xbf\xbd"
    
    type myString string
    myString('\u65e5')   // "\u65e5" == "日" == "\xe6\x97\xa5"
    

    注意:这种形式的转换可能最终被语言移除。go vet 工具将某些整数到字符串的转换标记为潜在错误。应改用库函数如 utf8.AppendRuneutf8.EncodeRune

切片到数组或数组指针的转换

将切片转换为数组产生包含切片底层数组元素的数组。类似地,将切片转换为数组指针产生指向切片底层数组的指针。两种情况下,如果切片的长度小于数组长度,发生运行时恐慌

s := make([]byte, 2, 4)

a0 := [0]byte(s)
a1 := [1]byte(s[1:])     // a1[0] == s[1]
a2 := [2]byte(s)         // a2[0] == s[0]
a4 := [4]byte(s)         // panic: len([4]byte) > len(s)

s0 := (*[0]byte)(s)      // s0 != nil
s1 := (*[1]byte)(s[1:])  // &s1[0] == &s[1]
s2 := (*[2]byte)(s)      // &s2[0] == &s[0]
s4 := (*[4]byte)(s)      // panic: len([4]byte) > len(s)

var t []string
t0 := [0]string(t)       // nil 切片 t 合法
t1 := (*[0]string)(t)    // t1 == nil
t2 := (*[1]string)(t)    // panic: len([1]string) > len(t)

u := make([]byte, 0)
u0 := (*[0]byte)(u)      // u0 != nil

常量表达式

常量表达式只能包含常量操作数并在编译时求值。

无类型布尔、数值和字符串常量可在任何可使用布尔、数值或字符串类型操作数的地方用作操作数。

常量比较始终产生无类型布尔常量。如果常量移位表达式的左操作数是无类型常量,结果是无类型整数常量;否则是左操作数同类型的常量,左操作数必须是整数类型

对无类型常量的任何其他运算产生同种类的无类型常量;即布尔、整数、浮点、复数或字符串常量。如果二元运算(移位除外)的无类型操作数种类不同,结果取列表中后出现的操作数种类:整数、符文、浮点、复数。例如,无类型整数常量除以无类型复数常量产生无类型复数常量。

const a = 2 + 3.0          // a == 5.0   (无类型浮点常量)
const b = 15 / 4           // b == 3     (无类型整数常量)
const c = 15 / 4.0         // c == 3.75  (无类型浮点常量)
const Θ float64 = 3/2      // Θ == 1.0   (类型 float64, 3/2 是整数除法)
const Π float64 = 3/2.     // Π == 1.5   (类型 float64, 3/2. 是浮点除法)
const d = 1 << 3.0         // d == 8     (无类型整数常量)
const e = 1.0 << 3         // e == 8     (无类型整数常量)
const f = int32(1) << 33   // 非法       (常量 8589934592 溢出 int32)
const g = float64(2) >> 1  // 非法       (float64(2) 是类型化浮点常量)
const h = "foo" > "bar"    // h == true  (无类型布尔常量)
const j = true             // j == true  (无类型布尔常量)
const k = 'w' + 1          // k == 'x'   (无类型符文常量)
const l = "hi"             // l == "hi"  (无类型字符串常量)
const m = string(k)        // m == "x"   (类型 string)
const Σ = 1 - 0.707i       //            (无类型复数常量)
const Δ = Σ + 2.0e-4       //            (无类型复数常量)
const Φ = iota*1i - 1/1i   //            (无类型复数常量)

对无类型整数、符文或浮点常量应用内置函数 complex 产生无类型复数常量。

const ic = complex(0, c)   // ic == 3.75i  (无类型复数常量)
const iΘ = complex(0, Θ)   // iΘ == 1i     (类型 complex128)

常量表达式始终精确求值;中间值和常量本身可能需要比语言任何预声明类型支持的显著更大的精度。以下是合法声明:

const Huge = 1 << 100         // Huge == 1267650600228229401496703205376  (无类型整数常量)
const Four int8 = Huge >> 98  // Four == 4                                (类型 int8)

常量除法或取余操作的除数不能为零:

3.14 / 0.0   // 非法: 除零

_类型化_常量的值必须始终能由常量类型的值精确表示。以下常量表达式非法:

uint(-1)     // -1 不能表示为 uint
int(3.14)    // 3.14 不能表示为 int
int64(Huge)  // 1267650600228229401496703205376 不能表示为 int64
Four * 300   // 操作数 300 不能表示为 int8 (Four 的类型)
Four * 100   // 乘积 400 不能表示为 int8 (Four 的类型)

无类型常量使用一元位补码运算符 ^ 的掩码匹配非常量规则:无符号常量掩码全为 1,有符号和无类型常量掩码为 -1。

^1         // 无类型整数常量,等于 -2
uint8(^1)  // 非法: 同 uint8(-2), -2 不能表示为 uint8
^uint8(1)  // 类型化 uint8 常量,同 0xFF ^ uint8(1) = uint8(0xFE)
int8(^1)   // 同 int8(-2)
^int8(1)   // 同 -1 ^ int8(1) = -2

实现限制:编译器计算无类型浮点或复数常量表达式时可能使用舍入;参见常量部分的实现限制。这种舍入可能导致浮点常量表达式在整数上下文中无效,即使无限精度计算时为整数值,反之亦然。

求值顺序

在包级别,初始化依赖决定变量声明中各个初始化表达式的求值顺序。否则,求值表达式、赋值或返回语句的操作数时,所有函数调用、方法调用、接收操作二元逻辑运算按词法从左到右顺序求值。

例如,在(函数局部)赋值

y[f()], ok = g(z || h(), i()+x[j()], <-c), k()

函数调用和通信按顺序 f(), h()(若 z 求值为假), i(), j(), <-c, g(), 和 k() 发生。但与 x 的求值和索引及 yz 的求值相比,这些事件的顺序未指定,仅词法要求除外。例如,g 的参数求值前不能调用 g

a := 1
f := func() int { a++; return a }
x := []int{a, f()}            // x 可能是 [1, 2] 或 [2, 2]: a 和 f() 的求值顺序未指定
m := map[int]int{a: 1, a: 2}  // m 可能是 {2: 1} 或 {2: 2}: 两次映射赋值的求值顺序未指定
n := map[int]int{a: f()}      // n 可能是 {2: 3} 或 {3: 3}: 键和值的求值顺序未指定

在包级别,初始化依赖覆盖各个初始化表达式的从左到右规则,但不覆盖每个表达式内部的操作数:

var a, b, c = f() + v(), g(), sqr(u()) + v()

func f() int        { return c }
func g() int        { return a }
func sqr(x int) int { return x*x }

// 函数 u 和 v 独立于所有其他变量和函数

函数调用顺序为 u(), sqr(), v(), f(), v(), 和 g()

表达式内的浮点运算根据运算符结合性求值。显式括号通过覆盖默认结合性影响求值。在表达式 x + (y + z) 中,加法 y + z 在加 x 前执行。

语句

语句控制执行。

Statement  = Declaration | LabeledStmt | SimpleStmt |
             GoStmt | ReturnStmt | BreakStmt | ContinueStmt | GotoStmt |
             FallthroughStmt | Block | IfStmt | SwitchStmt | SelectStmt | ForStmt |
             DeferStmt .

SimpleStmt = EmptyStmt | ExpressionStmt | SendStmt | IncDecStmt | Assignment | ShortVarDecl .

终止语句

终止语句 中断中的常规控制流。以下语句是终止语句:

  1. "return""goto" 语句。

  2. 对内置函数 panic 的调用。

  3. 以终止语句结尾的

  4. "if" 语句,其中:

    • 存在 "else" 分支,且
    • 两个分支都是终止语句。
  5. "for" 语句,其中:

    • 没有引用该 "for" 语句的 "break" 语句,且
    • 循环条件不存在,且
    • "for" 语句不使用 range 子句。
  6. "switch" 语句,其中:

    • 没有引用该 "switch" 语句的 "break" 语句,
    • 有默认情况,且
    • 每个情况(包括默认情况)的语句列表以终止语句结尾,或带标签的"fallthrough" 语句结尾。
  7. "select" 语句,其中:

    • 没有引用该 "select" 语句的 "break" 语句,且
    • 每个情况(包括存在的默认情况)的语句列表以终止语句结尾。
  8. 标记终止语句的标记语句

其他语句都不是终止语句。

如果语句列表非空且其最终非空语句是终止语句,则称语句列表以终止语句结尾。

空语句

空语句不执行任何操作。

EmptyStmt = .

标记语句

标记语句可以是 gotobreakcontinue 语句的目标。

LabeledStmt = Label ":" Statement .
Label       = identifier .
Error: log.Panic("error encountered")

表达式语句

除特定内置函数外,函数和方法调用接收操作可出现在语句上下文中。此类语句可加括号。

ExpressionStmt = Expression .

以下内置函数不允许出现在语句上下文中:

append cap complex imag len make new real
unsafe.Add unsafe.Alignof unsafe.Offsetof unsafe.Sizeof unsafe.Slice unsafe.SliceData unsafe.String unsafe.StringData
h(x+y)
f.Close()
<-ch
(<-ch)
len("foo")  // 非法,若 len 是内置函数

发送语句

发送语句在通道上发送值。通道表达式必须是通道类型,通道方向必须允许发送操作,且待发送值的类型必须可赋值给通道的元素类型。

SendStmt = Channel "<-" Expression .
Channel  = Expression .

通信开始前先求值通道和值表达式。通信阻塞直到发送可继续。无缓冲通道的发送可继续,如果有接收者准备就绪。缓冲通道的发送可继续,如果缓冲区有空间。关闭的通道发送会导致运行时恐慌nil 通道发送永远阻塞。

ch <- 3  // 向通道 ch 发送值 3

如果通道表达式的类型是类型参数,其类型集合中所有类型必须是允许发送操作的通道类型,它们必须具有相同元素类型,且待发送值的类型必须可赋值给该元素类型。

自增自减语句

"++" 和 "--" 语句将其操作数递增或递减无类型常量 1。与赋值类似,操作数必须可寻址或映射索引表达式。

IncDecStmt = Expression ( "++" | "--" ) .

以下赋值语句在语义上等价:

自增自减语句    赋值
x++                 x += 1
x--                 x -= 1

赋值语句

赋值 用表达式指定的新值替换变量中存储的当前值。赋值语句可将单个值赋给单个变量,或多个值赋给匹配数量的变量。

Assignment = ExpressionList assign_op ExpressionList .

assign_op  = [ add_op | mul_op ] "=" .

每个左侧操作数必须可寻址、映射索引表达式,或(仅用于 = 赋值)空标识符。操作数可加括号。

x = 1
*p = f()
a[i] = 23
(k) = <-ch  // 同: k = <-ch

赋值运算 x op= y(其中 op 是二元算术运算符)等价于 x = x op (y),但 x 仅求值一次。op= 构造是单个标记。在赋值运算中,左右两侧表达式列表都必须恰好包含一个单值表达式,且左侧表达式不能是空标识符。

a[i] <<= 2
i &^= 1<<n

元组赋值将多值操作的各个元素赋给变量列表。有两种形式。第一种形式中,右侧操作数是单个多值表达式,如函数调用、通道映射操作,或类型断言。左侧操作数数量必须匹配值的数量。例如,若 f 是返回两个值的函数,

x, y = f()

将第一个值赋给 x,第二个值赋给 y。第二种形式中,左侧操作数数量必须等于右侧表达式数量,每个表达式必须是单值的,第 n 个右侧表达式赋给左侧第 n 个操作数:

one, two, three = '一', '二', '三'

空标识符提供忽略赋值右侧值的方式:

_ = x       // 求值 x 但忽略
x, _ = f()  // 求值 f() 但忽略第二个结果值

赋值分两个阶段进行。首先,左侧的索引表达式指针间接(包括选择器中的隐式指针间接)以及右侧的表达式全部按常规顺序求值。其次,赋值按从左到右的顺序执行。

a, b = b, a  // 交换 a 和 b

x := []int{1, 2, 3}
i := 0
i, x[i] = 1, 2  // 设 i = 1, x[0] = 2

i = 0
x[i], i = 2, 1  // 设 x[0] = 2, i = 1

x[0], x[0] = 1, 2  // 设 x[0] = 1, 然后设 x[0] = 2 (最终 x[0] == 2)

x[1], x[3] = 4, 5  // 设 x[1] = 4,然后 panic 设 x[3] = 5

type Point struct { x, y int }
var p *Point
x[2], p.x = 6, 7  // 设 x[2] = 6,然后 panic 设 p.x = 7

i = 2
x = []int{3, 5, 7}
for i, x[i] = range x {  // 设 i, x[2] = 0, x[0]
break
}
// 循环后 i == 0 且 x 为 []int{3, 5, 3}

赋值时,每个值必须可赋值给赋值的操作数类型,有以下特殊情况:

  1. 任何类型值都可赋给空标识符。
  2. 如果无类型常量赋给接口类型的变量或空标识符,常量先隐式转换默认类型
  3. 如果无类型布尔值赋给接口类型的变量或空标识符,先隐式转换为 bool 类型。

将值赋给变量时,只替换变量中存储的数据。如果值包含引用,赋值只复制引用而不复制引用的数据(如切片的底层数组)。

var s1 = []int{1, 2, 3}
var s2 = s1                    // s2 存储 s1 的切片描述符
s1 = s1[:1]                    // s1 长度为 1 但仍与 s2 共享底层数组
s2[0] = 42                     // 设 s2[0] 同时改变 s1[0]
fmt.Println(s1, s2)            // 打印 [42] [42 2 3]

var m1 = make(map[string]int)
var m2 = m1                    // m2 存储 m1 的映射描述符
m1["foo"] = 42                 // 设 m1["foo"] 同时改变 m2["foo"]
fmt.Println(m2["foo"])         // 打印 42

If 语句

"If" 语句根据布尔表达式的值指定两个分支的条件执行。如果表达式求值为真,执行 "if" 分支;否则执行存在的 "else" 分支。

IfStmt = "if" [ SimpleStmt ";" ] Expression Block [ "else" ( IfStmt | Block ) ] .
if x > max {
x = max
}

表达式前可有简单语句,在表达式求值前执行。

if x := f(); x < y {
return x
} else if x > z {
return z
} else {
return y
}

Switch 语句

"Switch" 语句提供多路执行。将表达式或类型与 "switch" 内的 "cases" 比较以确定执行哪个分支。

SwitchStmt = ExprSwitchStmt | TypeSwitchStmt .

有两种形式:表达式 switch 和类型 switch。在表达式 switch 中,cases 包含与 switch 表达式的值比较的表达式。在类型 switch 中,cases 包含与特殊标注的 switch 表达式的类型比较的类型。switch 表达式在 switch 语句中只求值一次。

表达式 switch

在表达式 switch 中,switch 表达式求值后,case 表达式(不必是常量)从左到右、从上到下求值;第一个等于 switch 表达式的 case 触发关联 case 语句的执行;其他 case 被跳过。若无 case 匹配且有 "default" case,则执行其语句。最多一个 default case,且可出现在 "switch" 语句的任何位置。缺失的 switch 表达式等价于布尔值 true

ExprSwitchStmt = "switch" [ SimpleStmt ";" ] [ Expression ] "{" { ExprCaseClause } "}" .
ExprCaseClause = ExprSwitchCase ":" StatementList .
ExprSwitchCase = "case" ExpressionList | "default" .

如果 switch 表达式求值为无类型常量,先隐式转换默认类型。预声明的无类型值 nil 不能用作 switch 表达式。switch 表达式类型必须可比较

如果 case 表达式是无类型的,先隐式转换为 switch 表达式的类型。对于每个(可能转换的)case 表达式 x 和 switch 表达式的值 t,必须满足 x == t 是有效的比较

换句话说,switch 表达式被视为声明并初始化无显式类型的临时变量 t;将 t 的值与每个 case 表达式 x 进行相等测试。

在 case 或 default 子句中,最后一个非空语句可以是(可能标记"fallthrough" 语句,表示控制应从此子句末尾流到下一个子句的第一条语句。否则控制流到 "switch" 语句末尾。"fallthrough" 语句可出现在表达式 switch 除最后一个子句外的任何子句的最后语句。

switch 表达式前可有简单语句,在表达式求值前执行。

switch tag {
default: s3()
case 0, 1, 2, 3: s1()
case 4, 5, 6, 7: s2()
}

switch x := f(); {  // 缺失 switch 表达式表示 "true"
case x < 0: return -x
default: return x
}

switch {
case x < y: f1()
case x < z: f2()
case x == 4: f3()
}

实现限制:编译器可能禁止多个 case 表达式求值为同一常量。例如,当前编译器禁止 case 表达式中出现重复的整数、浮点或字符串常量。

类型 switch

类型 switch 比较类型而非值。其他方面类似表达式 switch。它用特殊 switch 表达式标记,该表达式具有类型断言的形式,但用关键字 type 而非实际类型:

switch x.(type) {
// cases
}

cases 将实际类型 T 与表达式 x 的动态类型比较。与类型断言类似,x 必须是接口类型,但不能是类型参数,且每个 case 中列出的非接口类型 T 必须实现 x 的类型。type switch 中 case 列出的类型必须全部不同

TypeSwitchStmt  = "switch" [ SimpleStmt ";" ] TypeSwitchGuard "{" { TypeCaseClause } "}" .
TypeSwitchGuard = [ identifier ":=" ] PrimaryExpr "." "(" "type" ")" .
TypeCaseClause  = TypeSwitchCase ":" StatementList .
TypeSwitchCase  = "case" TypeList | "default" .

TypeSwitchGuard 可包含短变量声明。使用此形式时,变量在 TypeSwitchCase 的每个子句的隐式块末尾声明。在恰好列出一个类型的 case 子句中,变量具有该类型;否则变量具有 TypeSwitchGuard 中表达式的类型。

case 可用预声明标识符 nil 代替类型;当 TypeSwitchGuard 中的表达式为 nil 接口值时选择该 case。最多一个 nil case。

给定类型为 interface{} 的表达式 x,以下类型 switch:

switch i := x.(type) {
case nil:
printString("x is nil")                // i 的类型是 x 的类型 (interface{})
case int:
printInt(i)                            // i 的类型是 int
case float64:
printFloat64(i)                        // i 的类型是 float64
case func(int) float64:
printFunction(i)                       // i 的类型是 func(int) float64
case bool, string:
printString("type is bool or string")  // i 的类型是 x 的类型 (interface{})
default:
printString("don't know the type")     // i 的类型是 x 的类型 (interface{})
}

可重写为:

v := x  // x 只求值一次
if v == nil {
i := v                                 // i 的类型是 x 的类型 (interface{})
printString("x is nil")
} else if i, isInt := v.(int); isInt {
printInt(i)                            // i 的类型是 int
} else if i, isFloat64 := v.(float64); isFloat64 {
printFloat64(i)                        // i 的类型是 float64
} else if i, isFunc := v.(func(int) float64); isFunc {
printFunction(i)                       // i 的类型是 func(int) float64
} else {
_, isBool := v.(bool)
_, isString := v.(string)
if isBool || isString {
i := v                         // i 的类型是 x 的类型 (interface{})
printString("type is bool or string")
} else {
i := v                         // i 的类型是 x 的类型 (interface{})
printString("don't know the type")
}
}

类型参数泛型类型可用作 case 中的类型。如果实例化后该类型与其他 switch 条目重复,则选择第一个匹配的 case。

func f[P any](x any) int {
switch x.(type) {
case P:
return 0
case string:
return 1
case []P:
return 2
case []byte:
return 3
default:
return 4
}

var v1 = f[string]("foo")   // v1 == 0
var v2 = f[byte]([]byte{})  // v2 == 2

TypeSwitchGuard 前可有简单语句,在 guard 求值前执行。

类型 switch 中不允许 "fallthrough" 语句。

For 语句

"For" 语句指定块的重复执行。有三种形式:迭代可由单个条件、"for" 子句或 "range" 子句控制。

ForStmt   = "for" [ Condition | ForClause | RangeClause ] Block .
Condition = Expression .

单条件 For 语句

最简单的形式中,"for" 语句指定块重复执行,只要布尔条件求值为真。每次迭代前求值条件。如果条件缺失,等价于布尔值 true

for a < b {
a *= 2
}

带 ForClause 的 For 语句

带 ForClause 的 "for" 语句也由其条件控制,但额外指定 initpost 语句,如赋值、自增或自减语句。init 语句可以是短变量声明,但 post 语句不能。

ForClause = [ InitStmt ] ";" [ Condition ] ";" [ PostStmt ] .
InitStmt  = SimpleStmt .
PostStmt  = SimpleStmt .
for i := 0; i < 10; i++ {
f(i)
}

若非空,init 语句执行一次,在首次迭代前求值条件;post 语句执行于每次块执行后(且仅在块执行时)。ForClause 的任何元素可为空,但分号要求除非仅有条件。如果条件缺失,等价于布尔值 true

for cond { S() }    同    for ; cond ; { S() }
for      { S() }    同    for true     { S() }

每个迭代有独立的声明变量(或变量) [Go 1.22]。首次迭代使用的变量由 init 语句声明。后续迭代使用的变量在执行 post 语句前隐式声明并初始化为前次迭代变量的值。

var prints []func()
for i := 0; i < 5; i++ {
prints = append(prints, func() { println(i) })
i++
}
for _, p := range prints {
p()
}

输出

1
3
5

在 [Go 1.22] 前,迭代共享一组变量而非独立变量。此时上述示例输出

6
6
6

range 子句的 For 语句

带 "range" 子句的 "for" 语句遍历数组、切片、字符串或映射的所有条目、通道上接收的值、从零到上限的整数值 [Go 1.22] 或传递给迭代器函数的 yield 函数的值 [Go 1.23]。对每个条目,如果存在,将_迭代值_赋给相应的_迭代变量_,然后执行块。

RangeClause = [ ExpressionList "=" | IdentifierList ":=" ] "range" Expression .

"range" 子句右侧的表达式称为 range 表达式,可以是数组、指向数组的指针、切片、字符串、允许接收操作的通道、整数或具有特定签名的函数(见下文)。与赋值类似,如果左侧存在操作数,必须是可寻址或映射索引表达式;它们表示迭代变量。如果 range 表达式是函数,迭代变量的最大数量取决于函数签名。如果 range 表达式是通道或整数,最多允许一个迭代变量;否则最多允许两个。如果最后一个迭代变量是空标识符,range 子句等价于不包含该标识符的相同子句。

Range 表达式 x 在循环开始前求值,有一个例外:如果最多一个迭代变量存在且 xlen(x)常量,则不求值 range 表达式。

每次迭代时,如果存在相应的迭代变量,按以下方式生成迭代值:

range 表达式                                       第1个值                第2个值

数组或切片      a  [n]E, *[n]E, 或 []E             索引    i  int          a[i]       E
字符串              s  string 类型                     索引    i  int          见下文      符文
映射                 m  map[K]V                         键      k  K            m[k]       V
通道             c  chan E, <-chan E                元素  e  E
整数值       n  整数类型或无类型整数常量           值      i  见下文
函数, 0 值   f  func(func() bool)
函数, 1 值   f  func(func(V) bool)              值      v  V
函数, 2 值   f  func(func(K, V) bool)           键      k  K            v          V
  1. 对于数组、指向数组的指针或切片值 a,索引迭代值按递增顺序从元素索引 0 开始生成。如果最多一个迭代变量存在,range 循环从 0 到 len(a)-1 生成迭代值,且不对数组或切片本身进行索引。对于 nil 切片,迭代次数为 0。
  2. 对于字符串值,"range" 子句从字节索引 0 开始迭代字符串中的 Unicode 代码点。连续迭代中,索引值将是字符串中连续 UTF-8 编码代码点的第一个字节的索引,第二个值(类型为 rune)将是相应代码点的值。如果迭代遇到无效 UTF-8 序列,第二个值将是 0xFFFD(Unicode 替换字符),下一次迭代将在字符串中前进一个字节。
  3. 映射的迭代顺序未指定且不保证连续迭代相同。如果迭代中移除尚未到达的映射条目,不会生成对应的迭代值。如果迭代中创建映射条目,该条目可能在迭代中生成或跳过。选择可能因创建的每个条目及连续迭代而异。如果映射为 nil,迭代次数为 0。
  4. 对于通道,迭代值是通道上发送的连续值,直到通道关闭。如果通道为 nil,range 表达式永远阻塞。
  5. 对于整数值 n(其中 n整数类型或无类型整数常量),按递增顺序生成 0 到 n-1 的迭代值。如果 n 是整数类型,迭代值具有相同类型。否则,n 的类型按赋值给迭代变量确定。具体地:如果迭代变量已存在,迭代值的类型是迭代变量的类型(必须是整数类型)。否则,如果迭代变量由 "range" 子句声明或不存在,迭代值的类型是 n默认类型。如果 n ≤ 0,循环不执行任何迭代。
  6. 对于函数 f,迭代通过将 f 与新的合成 yield 函数作为参数调用进行。如果 yieldf 返回前被调用,yield 的参数成为执行循环体一次的迭代值。每次循环迭代后,yield 返回 true 并可再次调用继续循环。只要循环体不终止,"range" 子句将持续为每次 yield 调用生成迭代值,直到 f 返回。如果循环体终止(如通过 break 语句),yield 返回 false 且不得再次调用。

迭代变量可用短变量声明的形式由 "range" 子句声明(:=)。此时它们的作用域是 "for" 语句的块,且每个迭代有独立的新变量 [Go 1.22](见 "for" 语句带 ForClause 部分)。变量具有相应迭代值的类型。

如果迭代变量未由 "range" 子句显式声明,则必须已存在。此时迭代值按赋值语句的方式赋给相应变量。

var testdata *struct {
a *[7]int
}
for i, _ := range testdata.a {
// testdata.a 永不求值;len(testdata.a) 是常量
// i 从 0 到 6
f(i)
}

var a [10]string
for i, s := range a {
// i 的类型是 int
// s 的类型是 string
// s == a[i]
g(i, s)
}

var key string
var val interface{}  // m 的元素类型可赋值给 val
m := map[string]int{"mon":0, "tue":1, "wed":2, "thu":3, "fri":4, "sat":5, "sun":6}
for key, val = range m {
h(key, val)
}
// key == 迭代中遇到的最后一个映射键
// val == map[key]

var ch chan Work = producer()
for w := range ch {
doWork(w)
}

// 清空通道
for range ch {}

// 调用 f(0), f(1), ..., f(9)
for i := range 10 {
// i 的类型是 int (无类型常量 10 的默认类型)
f(i)
}

// 无效: 256 不能赋给 uint8
var u uint8
for u = range 256 {
}

// 无效: 1e3 是浮点常量
for range 1e3 {
}

// fibo 生成斐波那契序列
fibo := func(yield func(x int) bool) {
f0, f1 := 0, 1
for yield(f0) {
f0, f1 = f1, f0+f1
}
}

// 打印 1000 以下的斐波那契数:
for x := range fibo {
if x >= 1000 {
break
}
fmt.Printf("%d ", x)
}
// 输出: 0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987

// 对递归树数据结构的支持
type Tree[K cmp.Ordered, V any] struct {
left, right *Tree[K, V]
key         K
value       V
}

func (t *Tree[K, V]) walk(yield func(key K, val V) bool) bool {
return t == nil || t.left.walk(yield) && yield(t.key, t.value) && t.right.walk(yield)
}

func (t *Tree[K, V]) Walk(yield func(key K, val V) bool) {
t.walk(yield)
}

// 中序遍历树 t
var t Tree[string, int]
for k, v := range t.Walk {
// 处理 k, v
}

如果 range 表达式的类型是类型参数,其类型集合中所有类型必须具有相同底层类型,且 range 表达式必须对该类型有效;或者,如果类型集合包含通道类型,则必须只包含具有相同元素类型的通道类型,且所有通道类型必须允许接收操作。

Go 语句

"Go" 语句在同一地址空间中作为独立并发线程(或 goroutine)启动函数调用的执行。

GoStmt = "go" Expression .

表达式必须是函数或方法调用;不能加括号。内置函数调用受表达式语句的限制。

函数值和参数在调用 goroutine 中按常规方式求值,但不同于常规调用,程序执行不等待被调用函数完成。相反,函数在新 goroutine 中独立执行。函数终止时其 goroutine 也终止。如果函数有返回值,函数完成时返回值被丢弃。

go Server()
go func(ch chan<- bool) { for { sleep(10); ch <- true }} (c)

Select 语句

"select" 语句从一组可能的发送接收操作中选择将进行的操作。它类似"switch"语句,但所有 case 都引用通信操作。

SelectStmt = "select" "{" { CommClause } "}" .
CommClause = CommCase ":" StatementList .
CommCase   = "case" ( SendStmt | RecvStmt ) | "default" .
RecvStmt   = [ ExpressionList "=" | IdentifierList ":=" ] RecvExpr .
RecvExpr   = Expression .

带 RecvStmt 的 case 可将 RecvExpr 的结果赋给一个或两个变量,可用短变量声明声明。RecvExpr 必须是(可能加括号)接收操作。最多一个 default case,可出现在 case 列表的任何位置。

"select" 语句的执行按以下步骤进行:

  1. 对于语句中的所有 case,接收操作的通道操作数和发送语句的通道及右侧表达式按源码顺序只求值一次,在 "select" 语句进入时。结果是接收或发送的通道集合及对应的发送值。求值中的任何副作用都会发生,无论选择哪种通信操作进行。带短变量声明或赋值的 RecvStmt 左侧表达式尚未求值。
  2. 如果有一个或多个通信操作可进行,则通过均匀伪随机选择选择其中可进行的一个。否则如果有 default case,则选择 default case。如果没有 default case,"select" 语句阻塞直到至少一个通信操作可进行。
  3. 除非选择的 case 是 default case,否则执行相应的通信操作。
  4. 如果选择的 case 是带短变量声明或赋值的 RecvStmt,则求值左侧表达式并赋接收值(或多个值)。
  5. 执行选择的 case 的语句列表。

由于 nil 通道上的通信永远无法进行,只有 nil 通道且无 default case 的 select 永远阻塞。

var a []int
var c, c1, c2, c3, c4 chan int
var i1, i2 int
select {
case i1 = <-c1:
print("received ", i1, " from c1\n")
case c2 <- i2:
print("sent ", i2, " to c2\n")
case i3, ok := (<-c3):  // 同: i3, ok := <-c3
if ok {
print("received ", i3, " from c3\n")
} else {
print("c3 is closed\n")
}
case a[f()] = <-c4:
// 同:
// case t := <-c4
//a[f()] = t
default:
print("no communication\n")
}

for {  // 向 c 发送随机比特序列
select {
case c <- 0:  // 注意: 无语句,无 fallthrough,无 case 折叠
case c <- 1:
}
}

select {}  // 永远阻塞

返回语句

函数 F 中的 "return" 语句终止 F 的执行,并可选择提供多个结果值。任何由 F 延迟的函数在 F 返回调用者前执行。

ReturnStmt = "return" [ ExpressionList ] .

在无结果类型的函数中,"return" 语句不得指定结果值。

func noResult() {
return
}

有结果类型的函数返回值有三种方式:

  1. 返回值可在 "return" 语句中显式列出。每个表达式必须单值且可赋值给函数结果类型的对应元素。

    func simpleF() int {
    return 2
    }
    
    func complexF1() (re float64, im float64) {
    return -7.0, -4.0
    }
    
  2. "return" 语句中的表达式列表可以是多值函数的单个调用。效果如同该函数返回的每个值都赋给具有相应值的临时变量,然后 "return" 语句列出这些变量,此时适用前一情况的规则。

    func complexF2() (re float64, im float64) {
    return complexF1()
    }
    
  3. 如果函数的结果类型指定了结果参数的名称,则表达式列表可为空。结果参数充当普通局部变量,函数可按需赋给它们值。"return" 语句返回这些变量的值。

    func complexF3() (re float64, im float64) {
    re = 7.0
    im = 4.0
    return
    }
    
    func (devnull) Write(p []byte) (n int, _ error) {
    n = len(p)
    return
    }
    

无论声明方式如何,所有结果值在函数入口时都初始化为类型的零值。指定结果的 "return" 语句在延迟函数执行前设置结果参数。

实现限制:如果结果参数同名且不同实体(常量、类型或变量)在 return 位置作用域内,则编译器可能禁止 "return" 语句中的空表达式列表。

func f(n int) (res int, err error) {
if _, err := f(n-1); err != nil {
return  // 无效返回语句: err 被遮蔽
}
return
}

Break 语句

"break" 语句终止同一函数内最内层"for""switch""select"语句的执行。

BreakStmt = "break" [ Label ] .

如果有标签,必须是包含的 "for"、"switch" 或 select 语句的标签,且终止该语句的执行。

OuterLoop:
for i = 0; i < n; i++ {
for j = 0; j < m; j++ {
switch a[i][j] {
case nil:
state = Error
break OuterLoop
case item:
state = Found
break OuterLoop
}
}
}

Continue 语句

"continue" 语句通过将控制推进到循环块末尾开始最内层包含"for" 循环的下一次迭代。"for" 循环必须在同一函数内。

ContinueStmt = "continue" [ Label ] .

如果有标签,必须是包含的 "for" 语句的标签,且推进该语句的执行。

RowLoop:
for y, row := range rows {
for x, data := range row {
if data == endOfRow {
continue RowLoop
}
row[x] = data + bias(x, y)
}
}

Goto 语句

"goto" 语句在同一函数内将控制转移到对应标签的语句。

GotoStmt = "goto" Label .
goto Error

执行 "goto" 语句不得导致任何变量进入作用域,而这些变量在 goto 位置尚未在作用域内。例如,以下示例:

goto L  // 错误
v := 3
L:

错误,因为跳转到标签 L 跳过了 v 的创建。

"goto" 语句在外不得跳转到该块内的标签。例如,以下示例:

if n%2 == 1 {
goto L1
}
for n > 0 {
f()
n--
L1:
f()
n--
}

错误,因为标签 L1 在 "for" 语句的块内,但 "goto" 在块外。

Fallthrough 语句

"fallthrough" 语句将控制转移到表达式 "switch" 语句的下一个 case 子句的第一条语句。只能作为此类子句的最后一个非空语句使用。

FallthroughStmt = "fallthrough" .

Defer 语句

"defer" 语句调用函数,其执行延迟到周围函数返回时,无论周围函数通过执行返回语句、到达函数体末尾或因相应 goroutine panicking而返回。

DeferStmt = "defer" Expression .

表达式必须是函数或方法调用;不能加括号。内置函数调用受表达式语句的限制。

每次执行 "defer" 语句时,函数值和调用参数按常规方式求值并保存,但不立即调用函数。相反,延迟函数在周围函数返回前立即调用,按延迟顺序的逆序调用。即,如果周围函数通过显式返回语句返回,则延迟函数在结果参数由返回语句设置后但在函数返回调用者前执行。如果延迟函数求值为 nil,函数调用时执行panic,而非 "defer" 语句执行时。

例如,如果延迟函数是函数字面量且周围函数有命名结果参数在字面量作用域内,延迟函数可在结果参数返回前访问和修改结果参数。如果延迟函数有返回值,函数完成时返回值被丢弃。(另见处理 panic部分。)

lock(l)
defer unlock(l)  // 解锁在周围函数返回前发生

// 周围函数返回前打印 3 2 1 0
for i := 0; i <= 3; i++ {
defer fmt.Print(i)
}

// f 返回 42
func f() (result int) {
defer func() {
// result 在返回语句设置为 6 后被访问
result *= 7
}()
return 6
}

内置函数

内置函数预声明。它们像其他函数一样调用,但其中一些函数接受类型而非表达式作为第一个参数。

内置函数没有标准 Go 类型,因此只能出现在调用表达式中;不能用作函数值。

切片追加和复制

内置函数 appendcopy 辅助切片常用操作。对于这两个函数,结果与参数引用的内存是否重叠无关。

可变参数函数 append 将零个或多个值 x 追加到类型 S 的切片 s 并返回结果切片(也是类型 S)。值 x 传递给类型 ...E 的参数,其中 ES 的元素类型,适用相应的参数传递规则。作为特殊情况,append 还接受可赋值给 []byte 类型的第一个参数,以及字符串类型的第二个参数后跟 ...。这种形式追加字符串的字节。

append(s S, x ...E) S  // E 是 S 的元素类型

如果 S类型参数,其类型集合中所有类型必须具有相同底层切片类型 []E

如果 s 的容量不足以容纳附加值,append分配新底层数组,其大小足够容纳现有切片元素和附加值。否则 append 重用底层数组。

s0 := []int{0, 0}
s1 := append(s0, 2)                // 追加单个元素     s1 是 []int{0, 0, 2}
s2 := append(s1, 3, 5, 7)          // 追加多个元素    s2 是 []int{0, 0, 2, 3, 5, 7}
s3 := append(s2, s0...)            // 追加切片          s3 是 []int{0, 0, 2, 3, 5, 7, 0, 0}
s4 := append(s3[3:6], s3[2:]...)   // 追加重叠切片    s4 是 []int{3, 5, 7, 2, 3, 5, 7, 0, 0}

var t []interface{}
t = append(t, 42, 3.1415, "foo")   //                             t 是 []interface{}{42, 3.1415, "foo"}

var b []byte
b = append(b, "bar"...)            // 追加字符串内容      b 是 []byte{'b', 'a', 'r' }

函数 copy 将源切片 src 的元素复制到目标切片 dst 并返回复制元素的数量。两个参数必须具有相同元素类型 E 且必须可赋值给类型 []E 的切片。复制的元素数量是 len(src)len(dst) 的最小值。作为特殊情况,copy 还接受可赋值给 []byte 类型的目标参数和字符串类型的源参数。这种形式将字符串的字节复制到字节切片。

copy(dst, src []T) int
copy(dst []byte, src string) int

如果一个或两个参数的类型是类型参数,其相应类型集合中所有类型必须具有相同底层切片类型 []E

示例:

var a = [...]int{0, 1, 2, 3, 4, 5, 6, 7}
var s = make([]int, 6)
var b = make([]byte, 5)
n1 := copy(s, a[0:])            // n1 == 6, s 是 []int{0, 1, 2, 3, 4, 5}
n2 := copy(s, s[2:])            // n2 == 4, s 是 []int{2, 3, 4, 5, 4, 5}
n3 := copy(b, "Hello, World!")  // n3 == 5, b 是 []byte("Hello")

清除

内置函数 clear 接受映射切片类型参数类型的参数,并删除或清零所有元素 [Go 1.21]。

调用        参数类型     结果

clear(m)    map[K]T           删除所有条目,结果为空映射 (len(m) == 0)

clear(s)    []T               将 s 的所有元素设为零值 T

clear(t)    type parameter    见下文

如果 clear 的参数类型是类型参数,其类型集合中所有类型必须是映射或切片,且 clear 执行与实际类型参数对应的操作。

如果映射或切片为 nilclear 是无操作。

关闭

对于通道 ch,内置函数 close(ch) 记录通道上不再发送值。如果 ch 是只接收通道,则错误。向关闭的通道发送或关闭 nil 通道也会导致运行时恐慌。调用 close 后,任何先前发送的值接收后,接收操作将返回通道类型的零值而不阻塞。多值接收操作返回接收值及通道是否关闭的指示。

如果 close 的参数类型是类型参数,其类型集合中所有类型必须是具有相同元素类型的通道。如果这些通道中有只接收通道,则错误。

复数操作

三个函数用于构造和分解复数。内置函数 complex 从浮点实部和虚部构造复数,而 realimag 提取复数的实部和虚部。

complex(realPart, imaginaryPart floatT) complexT
real(complexT) floatT
imag(complexT) floatT

参数和返回值的类型对应。对于 complex,两个参数必须是相同浮点类型,返回值是相应复数类型float32 参数返回 complex64float64 参数返回 complex128。如果参数求值为无类型常量,则先隐式转换为另一个参数的类型。如果两个参数都求值为无类型常量,它们必须是非复数或其虚部为零,函数返回无类型复数常量。

对于 realimag,参数必须是复数类型,返回值是相应浮点类型:complex64 参数返回 float32complex128 参数返回 float64。如果参数求值为无类型常量,它必须是复数,函数返回无类型浮点常量。

realimag 函数共同构成 complex 的逆,对于复数类型 Z 的值 zz == Z(complex(real(z), imag(z)))

如果这些函数的所有操作数都是常量,返回值是常量。

var a = complex(2, -2)             // complex128
const b = complex(1.0, -1.4)       // 无类型复数常量 1 - 1.4i
x := float32(math.Cos(math.Pi/2))  // float32
var c64 = complex(5, -x)           // complex64
var s int = complex(1, 0)          // 无类型复数常量 1 + 0i 可转换为 int
_ = complex(1, 2<<s)               // 非法: 2 假设浮点类型,不能移位
var rl = real(c64)                 // float32
var im = imag(a)                   // float64
const c = imag(b)                  // 无类型常量 -1.4
_ = imag(3 << s)                   // 非法: 3 假设复数类型,不能移位

类型参数类型的参数不允许。

映射元素删除

内置函数 delete映射 m 中删除键为 k 的元素。值 k 必须可赋值m 的键类型。

delete(m, k)  // 从映射 m 中删除元素 m[k]

如果 m 的类型是类型参数,其类型集合中所有类型必须是映射,且它们必须具有相同键类型。

如果映射 mnil 或元素 m[k] 不存在,delete 是无操作。

长度和容量

内置函数 lencap 接受各种类型的参数并返回 int 类型的结果。实现保证结果始终适合 int

调用      参数类型    结果

len(s)    string type      字符串长度(字节)
          [n]T, *[n]T      数组长度 (== n)
          []T              切片长度
          map[K]T          映射长度(已定义键的数量)
          chan T           通道缓冲区中的元素数量
          type parameter   见下文

cap(s)    [n]T, *[n]T      数组长度 (== n)
          []T              切片容量
          chan T           通道缓冲区容量
          type parameter   见下文

如果参数类型是类型参数 P,则调用 len(e)(或 cap(e))对 P 类型集合中的每种类型都必须有效。结果是 P实例化时对应类型参数的参数的长度(或容量)。

切片的容量是底层数组中已分配空间可容纳的元素数量。任何时候满足:

0 <= len(s) <= cap(s)

nil 切片、映射或通道的长度为 0。nil 切片或通道的容量为 0。 如果 s 是字符串常量,表达式 len(s)常量。如果 s 的类型是数组或指向数组的指针,并且表达式 s 不包含通道接收操作或(非常量)函数调用,那么表达式 len(s)cap(s) 也是常量;在这种情况下,s 不会被求值。否则,调用 lencap 不是常量,并且 s 会被求值。

const (
    c1 = imag(2i)                    // imag(2i) = 2.0 是常量
    c2 = len([10]float64{2})         // [10]float64{2} 不包含函数调用
    c3 = len([10]float64{c1})        // [10]float64{c1} 不包含函数调用
    c4 = len([10]float64{imag(2i)})  // imag(2i) 是常量,并且不发起函数调用
    c5 = len([10]float64{imag(z)})   // 无效:imag(z) 是(非常量)函数调用
)
var z complex128

创建切片、映射和通道

内建函数 make 接受一个类型 T,该类型必须是切片、映射或通道类型,或者是一个类型参数,后面可选择跟随特定类型的表达式列表。它返回类型为 T 的值(不是 *T)。内存的初始化在初始值部分有描述。

调用形式             类型 T            结果

make(T, n)       slice             类型为 T,长度为 n,容量为 n 的切片
make(T, n, m)    slice             类型为 T,长度为 n,容量为 m 的切片

make(T)          map               类型为 T 的映射
make(T, n)       map               类型为 T,初始空间可容纳约 n 个元素的映射

make(T)          channel           类型为 T 的无缓冲通道
make(T, n)       channel           类型为 T,缓冲区大小为 n 的有缓冲通道

make(T, n)       type parameter    见下文
make(T, n, m)    type parameter    见下文

如果第一个参数是类型参数,其类型集的所有类型必须具有相同的基础类型,该基础类型必须是切片或映射类型,或者,如果是通道类型,则必须是相同元素类型的通道类型,并且通道方向不能冲突。

每个大小参数 nm 必须是整数类型,其类型集只包含整数类型,或者是一个未类型化的常量。常量大小参数必须是非负数,并且可以由类型 int 的值表示;如果是未类型化的常量,则其类型被指定为 int。如果 nm 都提供且为常量,则 n 必须不大于 m。对于切片和通道,如果 n 在运行时是负数或大于 m,则会发生运行时恐慌

s := make([]int, 10, 100)       // 切片 len(s) == 10, cap(s) == 100
s := make([]int, 1e3)           // 切片 len(s) == cap(s) == 1000
s := make([]int, 1<<63)         // 非法: len(s) 无法用 int 类型值表示
s := make([]int, 10, 0)         // 非法: len(s) > cap(s)
c := make(chan int, 10)         // 缓冲大小为 10 的通道
m := make(map[string]int, 100)  // 初始空间可容纳约 100 个元素的映射

使用映射类型和大小提示 n 调用 make 将创建初始空间可容纳 n 个映射元素的映射。具体行为依赖于实现。

最小值和最大值

内建函数 minmax 计算一组固定数量有序类型参数的最小值(或最大值)。必须至少有一个参数 [Go 1.21]。

运算符相同的类型规则适用:对于有序参数 xy,如果 x + y 有效,则 min(x, y) 有效,且 min(x, y) 的类型与 x + y 的类型相同(对于 max 也类似)。如果所有参数都是常量,则结果为常量。

var x, y int
m := min(x)                 // m == x
m := min(x, y)              // m 是 x 和 y 中较小的
m := max(x, y, 10)          // m 是 x 和 y 中较大的,但至少为 10
c := max(1, 2.0, 10)        // c == 10.0 (浮点类型)
f := max(0, float32(x))     // f 的类型是 float32
var s []string
_ = min(s...)               // 无效: 不允许切片参数
t := max("", "foo", "bar")  // t == "foo" (字符串类型)

对于数值参数,假设所有 NaN 相等,minmax 是可交换和可结合的:

min(x, y)    == min(y, x)
min(x, y, z) == min(min(x, y), z) == min(x, min(y, z))

对于浮点参数负零、NaN 和无穷大,适用以下规则:

   x        y    min(x, y)    max(x, y)

  -0.0    0.0         -0.0          0.0    // 负零小于(非负)零
  -Inf      y         -Inf            y    // 负无穷小于任何其他数
  +Inf      y            y         +Inf    // 正无穷大于任何其他数
   NaN      y          NaN          NaN    // 如果任何参数是 NaN,结果就是 NaN

对于字符串参数,min 的结果是字典序最小(或 max 最大)的第一个参数:

min(x, y)    == if x <= y then x else y
min(x, y, z) == min(min(x, y), z)

分配

内建函数 new 接受一个类型 T,在运行时为该类型的变量分配存储空间,并返回一个指向该变量的类型为 *T指针值。变量按初始值部分描述进行初始化。

new(T)

例如

type S struct { a int; b float64 }
new(S)

为类型 S 的变量分配存储空间,将其初始化(a=0b=0.0),并返回一个包含该位置地址的 *S 类型的值。

处理恐慌

两个内建函数 panicrecover 协助报告和处理运行时恐慌和程序定义的错误条件。

func panic(interface{})
func recover() interface{}

在执行函数 F 时,显式调用 panic运行时恐慌会终止 F 的执行。然后,F 延迟执行的所有函数照常执行。接下来,F 的调用者延迟执行的所有函数被执行,依此类推,直到执行 goroutine 中的顶层函数的延迟函数。此时,程序终止,并报告错误条件,包括传递给 panic 的参数值。这个终止序列称为 panicking

panic(42)
panic("unreachable")
panic(Error("cannot parse"))

recover 函数允许程序管理 panic 的 goroutine 的行为。假设函数 G 延迟执行一个调用 recover 的函数 D,并且在与 G 执行的相同 goroutine 中的某个函数中发生 panic。当延迟函数的执行到达 D 时,Drecover 调用的返回值将是传递给 panic 调用的值。如果 D 正常返回,没有启动新的 panic,则 panicking 序列停止。在这种情况下,丢弃 Gpanic 调用之间的函数状态,恢复正常执行。然后运行 GD 之前延迟的所有函数,G 的执行通过返回其调用者而终止。

如果 goroutine 没有发生 panic,或者 recover 不是由延迟函数直接调用,则 recover 的返回值为 nil。相反,如果 goroutine 正在 panic,且 recover 是由延迟函数直接调用的,则 recover 的返回值保证不为 nil。为了确保这一点,使用 nil 接口值(或未类型化的 nil)调用 panic 会导致运行时恐慌

以下示例中的 protect 函数调用函数参数 g,并保护调用者免受由 g 引起的运行时恐慌。

func protect(g func()) {
defer func() {
log.Println("done")  // 即使有 panic,Println 也可以正常执行
if x := recover(); x != nil {
log.Printf("run time panic: %v", x)
}
}()
log.Println("start")
g()
}

启动

当前实现提供了几个在启动期间有用的内建函数。这些函数为了完整性而记录,但不保证会保留在语言中。它们不返回结果。

函数       行为

print      打印所有参数;参数的格式由实现决定
println    类似于 print,但在参数之间打印空格并在末尾打印换行符

实现限制:printprintln 不需要接受任意参数类型,但必须支持布尔、数值和字符串类型的打印。

Go 程序通过连接多个_包_来构建。一个包由多个源文件组成,这些源文件共同声明了属于该包的常量、类型、变量和函数,并且这些元素在同一个包的所有文件中都是可访问的。这些元素可以被导出并在其他包中使用。

源文件组织

每个源文件由定义其所属包的包子句组成,后跟一组可能为空的导入声明,声明希望使用的包的内容,然后是一组可能为空的函数、类型、变量和常量的声明。

SourceFile = PackageClause ";" { ImportDecl ";" } { TopLevelDecl ";" } .

包子句

每个源文件以包子句开始,定义该文件所属的包。

PackageClause = "package" PackageName .
PackageName   = identifier .

PackageName 不能是空标识符

package math

共享相同 PackageName 的一组文件形成包的实现。实现可能要求包的所有源文件都位于同一目录中。

导入声明

导入声明表明包含该声明的源文件依赖于_导入_包的功能(§程序初始化和执行),并启用对该包的导出标识符的访问。导入声明了一个用于访问的标识符(PackageName)和一个指定要导入包的 ImportPath。

ImportDecl = "import" ( ImportSpec | "(" { ImportSpec ";" } ")" ) .
ImportSpec = [ "." | PackageName ] ImportPath .
ImportPath = string_lit .

PackageName 在限定标识符中用于在导入源文件中访问包的导出标识符。它在文件块中声明。如果省略 PackageName,则默认使用导入包的包子句中指定的标识符。如果显式句点(.)代替名称出现,则该包包块中声明的所有导出标识符将在导入源文件的文件块中声明,并且必须无修饰符访问。

ImportPath 的解释依赖于实现,但通常是编译包完整文件名的子字符串,并且可能相对于已安装包的存储库。

实现限制:编译器可能限制 ImportPath 为仅使用属于 Unicode's L, M, N, P, 和 S 通用类别(无空格的图形字符)的字符,并且可能排除字符 !"#$%&'()*,:;&lt;=>?[\]^`{|} 和 Unicode 替换字符 U+FFFD。

考虑一个包含包子句 package math 的已编译包,它导出了函数 Sin,并在 "lib/math" 标识的文件中安装了编译包。下表说明了如何在不同类型的导入声明后,在导入包的文件中访问 Sin

导入声明                      Sin 的本地名称

import   "lib/math"         math.Sin
import m "lib/math"         m.Sin
import . "lib/math"         Sin

导入声明声明了导入包和导入包之间的依赖关系。包直接或间接导入自身是非法的,或者直接导入一个包而不引用其任何导出标识符也是非法的。为了仅为了其副作用(初始化)导入包,请使用标识符作为显式包名:

import _ "lib/math"

示例包

以下是一个实现并发质数筛选的完整 Go 包。

package main

import "fmt"

// 将序列 2, 3, 4, … 发送到通道 'ch'。
func generate(ch chan<- int) {
for i := 2; ; i++ {
ch <- i  // 将 'i' 发送到通道 'ch'。
}
}

// 从通道 'src' 复制值到通道 'dst',
// 移除那些可被 'prime' 整除的值。
func filter(src <-chan int, dst chan<- int, prime int) {
for i := range src {  // 遍历从 'src' 接收到的值。
if i%prime != 0 {
dst <- i  // 将 'i' 发送到通道 'dst'。
}
}
}

// 质数筛选器:将筛选器进程链在一起。
func sieve() {
ch := make(chan int)  // 创建一个新通道。
go generate(ch)       // 将 generate() 作为子进程启动。
for {
prime := <-ch
fmt.Print(prime, "\n")
ch1 := make(chan int)
go filter(ch, ch1, prime)
ch = ch1
}
}

func main() {
sieve()
}

程序初始化和执行

零值

当为变量分配存储空间时,无论是通过声明还是调用 new,或者创建新值,无论是通过复合字面量还是调用 make,并且没有提供显式初始化,则变量或值将给定默认值。这种变量或值的每个元素都设置为对应类型的_零值_:布尔类型为 false,数值类型为 0,字符串为 "",指针、函数、接口、切片、通道和映射为 nil。这种初始化是递归进行的,因此,例如,如果没有指定值,则结构体数组中的每个元素的字段都将被清零。

以下两个简单声明是等价的:

var i int
var i int = 0

type T struct { i int; f float64; next *T }
t := new(T)

之后,以下成立:

t.i == 0
t.f == 0.0
t.next == nil

以下也成立

var t T

包初始化

在包内,包级变量的初始化逐步进行,每个步骤选择_声明顺序_中最早且对未初始化变量没有依赖关系的变量。

更准确地说,如果包级变量尚未初始化,并且没有初始化表达式或其初始化表达式对未初始化变量没有_依赖_,则认为该变量_已准备好进行初始化_。初始化通过重复初始化声明顺序中最早且准备好初始化的下一个包级变量来进行,直到没有变量准备好初始化。

如果此过程结束时仍有变量未初始化,则这些变量属于一个或多个初始化循环,并且程序无效。

由右侧单个(多值)表达式初始化的变量声明左侧的多个变量将一起初始化:如果左侧的任何变量已初始化,则所有这些变量将在同一步骤中初始化。

var x = a
var a, b = f() // a 和 b 一起初始化,在 x 之前

出于包初始化的目的,变量在声明中被视为任何其他变量。

多文件声明的变量声明顺序由文件呈现给编译器的顺序决定:第一个文件中声明的变量在第二个文件中声明的任何变量之前声明,依此类推。为了确保可重复的初始化行为,构建系统应鼓励按字典文件名顺序向编译器呈现属于同一包的多个文件。

依赖分析不依赖于变量的实际值,仅依赖于源中对它们的词法_引用_,进行传递性分析。例如,如果变量 x 的初始化表达式引用了一个其主体引用变量 y 的函数,则 x 依赖于 y。具体来说:

  • 对变量或函数的引用是表示该变量或函数的标识符。
  • 对方法 m 的引用是形式为 t.m方法值方法表达式,其中 t 的(静态)类型不是接口类型,并且方法 mt方法集中。无论结果函数值 t.m 是否被调用都无关紧要。
  • 如果变量、函数或方法 x 的初始化表达式或主体(对于函数和方法)包含对 y 或依赖于 y 的函数或方法的引用,则 x 依赖于变量 y

例如,给定以下声明

var (
a = c + b  // == 9
b = f()    // == 4
c = f()    // == 5
d = 3      // == 5 after initialization has finished
)

func f() int {
d++
return d
}

初始化顺序是 d, b, c, a。注意初始化表达式中子表达式的顺序是无关紧要的:a = c + ba = b + c 在这个例子中导致相同的初始化顺序。 依赖分析按包进行;仅考虑引用当前包中声明的变量、函数和(非接口)方法的引用。如果变量之间存在其他隐藏的数据依赖关系,则这些变量之间的初始化顺序是未指定的。

例如,给定以下声明

var x = I(T{}).ab()   // x 对 a 和 b 有未检测到的隐藏依赖
var _ = sideEffect()  // 与 x, a, 或 b 无关
var a = b
var b = 42

type I interface      { ab() []int }
type T struct{}
func (T) ab() []int   { return []int{a, b} }

变量 a 将在 b 之后初始化,但 x 是在 b 之前、ba 之间还是 a 之后初始化,以及 sideEffect() 被调用的时刻(在 x 初始化之前或之后)是未指定的。

变量也可以使用在包块中声明的名为 init 的函数进行初始化,这些函数没有参数且没有结果参数。

func init() { … }

每个包可以定义多个这样的函数,甚至可以在单个源文件中定义多个。在包块中,init 标识符只能用于声明 init 函数,而标识符本身不会被声明。因此 init 函数在程序的任何地方都不能被引用。

整个包的初始化通过为其所有包级变量分配初始值,然后按照它们在源中出现的顺序调用所有 init 函数来完成,可能涉及多个文件,如呈现给编译器的顺序。

程序初始化

完整程序的包逐步初始化,一次一个包。如果一个包有导入,则在初始化该包本身之前先初始化导入的包。如果多个包导入同一个包,则导入的包只初始化一次。通过构造,包的导入保证了不存在循环初始化依赖关系。更精确地说:

给定所有包按导入路径排序的列表,在每个步骤中,列表中第一个未初始化的包,其所有导入的包(如果有)已经初始化,则被初始化。重复此步骤,直到所有包都初始化。

包初始化——变量初始化和 init 函数的调用——在单个 goroutine 中顺序发生,一次一个包。init 函数可以启动其他 goroutines,这些 goroutines 可以与初始化代码并发运行。然而,初始化总是按顺序执行 init 函数:在调用下一个 init 函数之前,前一个 init 函数必须返回。

程序执行

完整程序通过将一个单一的、未导入的包(称为 main 包)与它导入的所有包(传递性地)链接来创建。main 包必须有包名 main 并声明一个不带参数且不返回值的 main 函数。

func main() { … }

程序执行从初始化程序开始,然后调用 main 包中的 main 函数。当该函数调用返回时,程序退出。它不会等待其他(非 main)goroutines 完成。

错误

预声明类型 error 定义为

type error interface {
Error() string
}

它是表示错误条件的常规接口,nil 值表示没有错误。例如,从文件读取数据的函数可能定义为:

func Read(f *File, b []byte) (n int, err error)

运行时恐慌

执行错误,如尝试索引超出数组边界,会触发一个_运行时恐慌_,相当于调用内置函数 panic,其参数为实现定义的接口类型 runtime.Error。该类型满足预声明接口类型 error。表示不同运行时错误条件的精确错误值是未指定的。

package runtime

type Error interface {
error
// 可能还有其他方法
}

系统考虑

unsafe

内置包 unsafe 对编译器可见,并通过导入路径 "unsafe" 访问,提供低级编程设施,包括违反类型系统的操作。使用 unsafe 的包必须手动检查类型安全性,并且可能不可移植。该包提供以下接口:

package unsafe

type ArbitraryType int  // 任意 Go 类型的简写;不是真实类型
type Pointer *ArbitraryType

func Alignof(variable ArbitraryType) uintptr
func Offsetof(selector ArbitraryType) uintptr
func Sizeof(variable ArbitraryType) uintptr

type IntegerType int  // 整数类型的简写;不是真实类型
func Add(ptr Pointer, len IntegerType) Pointer
func Slice(ptr *ArbitraryType, len IntegerType) []ArbitraryType
func SliceData(slice []ArbitraryType) *ArbitraryType
func String(ptr *byte, len IntegerType) string
func StringData(str string) *byte

Pointer指针类型,但 Pointer 值不能被解引用。任何指针或底层类型为 uintptr 的值都可以转换为底层类型为 Pointer 的类型,反之亦然。如果相应类型是类型参数,则它们各自类型集中的所有类型必须具有相同的基础类型,分别为 uintptrPointerPointeruintptr 之间转换的效果是依赖于实现的。

var f float64
bits = *(*uint64)(unsafe.Pointer(&f))

type ptr unsafe.Pointer
bits = *(*uint64)(ptr(&f))

func f[P ~*B, B any](p P) uintptr {
return uintptr(unsafe.Pointer(p))
}

var p ptr = nil

函数 AlignofSizeof 接受任何类型的表达式 x,并分别返回假设变量 v 的对其或大小,就像 v 通过 var v = x 声明一样。

函数 Offsetof 接受一个(可能加括号的)选择器 s.f,表示结构体 s*s 的字段 f,并返回字段相对于结构体地址的字节偏移量。如果 f嵌入字段,则它必须可以通过结构体的字段无指针间接访问。对于具有字段 f 的结构体 s

uintptr(unsafe.Pointer(&s)) + unsafe.Offsetof(s.f) == uintptr(unsafe.Pointer(&s.f))

计算机架构可能要求内存地址_对齐_;即变量的地址是某个因子的倍数,该变量的类型的_对齐_。函数 Alignof 接受表示任何类型变量的表达式,并返回(变量类型的)对齐字节数。对于变量 x

uintptr(unsafe.Pointer(&x)) % unsafe.Alignof(x) == 0

(变量)类型 T 具有_可变大小_,如果 T类型参数,或者它是包含可变大小元素或字段的数组或结构体类型。否则大小是_常量_。如果其参数(或选择器表达式 s.f 中的结构体 s 对于 Offsetof)是常量大小类型,则对 AlignofOffsetofSizeof 的调用是类型 uintptr 的编译时常量表达式

函数 Addlen 加到 ptr 上并返回更新后的指针 unsafe.Pointer(uintptr(ptr) + uintptr(len)) [Go 1.17]。len 参数必须是整数类型或未类型化的常量。常量 len 参数必须可由类型 int 的值表示;如果是未类型化的常量,则其类型为 intPointer 的有效使用规则仍然适用。

函数 Slice 返回一个切片,其基础数组从 ptr 开始,其长度和容量为 lenSlice(ptr, len) 等价于

(*[len]ArbitraryType)(unsafe.Pointer(ptr))[:]

除了一个特殊情况,如果 ptrnillen 为零,Slice 返回 nil [Go 1.17]。

len 参数必须是整数类型或未类型化的常量。常量 len 参数必须是非负数,并且可由类型 int 的值表示;如果是未类型化的常量,则其类型为 int。在运行时,如果 len 为负数,或者 ptrnillen 不为零,则会发生运行时恐慌 [Go 1.17]。

函数 SliceData 返回 slice 参数的基础数组的指针。如果切片的容量 cap(slice) 不为零,则该指针为 &slice[:1][0]。如果 slicenil,则结果为 nil。否则它是对未指定内存地址的非 nil 指针 [Go 1.20]。

函数 String 返回一个 string 值,其基础字节从 ptr 开始,其长度为 lenptrlen 参数的要求与 Slice 函数相同。如果 len 为零,则结果为空字符串 ""。由于 Go 字符串是不可变的,传递给 String 的字节之后不能被修改 [Go 1.20]。

函数 StringData 返回 str 参数的基础字节的指针。对于空字符串,返回值是未指定的,可能为 nil。由于 Go 字符串是不可变的,StringData 返回的字节不能被修改 [Go 1.20]。

大小和对齐保证

对于数值类型,以下大小是保证的:

类型                                 字节大小

byte, uint8, int8                     1
uint16, int16                         2
uint32, int32, float32                4
uint64, int64, float64, complex64     8
complex128                           16

以下最小对齐属性是保证的:

  1. 对于任何类型的变量 xunsafe.Alignof(x) 至少为 1。
  2. 对于结构体类型的变量 xunsafe.Alignof(x)x 的每个字段 funsafe.Alignof(x.f) 值的最大值,但至少为 1。
  3. 对于数组类型的变量 xunsafe.Alignof(x) 与数组元素类型变量的对齐方式相同。

如果结构体或数组类型不包含任何大小大于零的字段(或元素),则其大小为零。两个不同的零大小变量可能在内存中具有相同的地址。

附录

语言版本

Go 1 兼容性保证确保根据 Go 1 规范编写的程序在该规范的整个生命周期内将继续正确编译和运行,且无需更改。更一般地,随着语言调整和添加功能,兼容性保证确保适用于特定 Go 语言版本的 Go 程序将继续适用于任何后续版本。

例如,使用 0b 前缀表示二进制整数字面值的能力是在 Go 1.13 中引入的,如整数字面值部分中的 [Go 1.13] 所示。如果编译器使用的隐含或必需的语言版本早于 Go 1.13,则包含 0b1011 等整数字面值的源代码将被拒绝。

下表描述了 Go 1 之后引入的功能所需的最低语言版本。

Go 1.9

Go 1.13

  • 整数字面值可以使用前缀 0b0B0o0O 分别表示二进制和八进制字面值。
  • 十六进制浮点字面值可以使用前缀 0x0X 编写。
  • 虚部后缀 i 可以用于任何(二进制、十进制、十六进制)整数或浮点字面值,而不仅仅是十进制字面值。
  • 任何数字字面值的数字可以使用下划线 _ 分隔(分组)。
  • 移位操作中的移位计数可以是带符号的整数类型。

Go 1.14

  • 通过不同的嵌入接口多次嵌入方法不是错误。

Go 1.17

  • 如果切片和数组元素类型匹配,并且数组长度不超过切片长度,则切片可以转换为数组指针。
  • 内置unsafe包括新的函数 AddSlice

Go 1.18

1.18 版本为语言添加了多态函数和类型(“泛型”)。具体来说:

Go 1.20

  • 如果切片和数组元素类型匹配,并且数组长度不超过切片长度,则切片可以转换为数组。
  • 内置unsafe包括新的函数 SliceDataStringStringData
  • 可比较类型(如普通接口)可以满足 comparable 约束,即使类型参数不是严格可比较的。

Go 1.21

  • 预声明函数集合包括新函数 minmaxclear
  • 类型推断使用接口方法的类型进行推断。它还为分配给变量或作为参数传递给其他(可能泛型)函数的泛型函数推断类型参数。

Go 1.22

  • "for" 语句中,每次迭代都有自己的迭代变量集,而不是在每次迭代中共享相同的变量。
  • 带有"range" 子句的 "for" 语句可以迭代从零到上限的整数值。

Go 1.23

  • 带有"range" 子句的 "for" 语句接受一个迭代器函数作为范围表达式。

Go 1.24

类型统一规则

类型统一规则描述了两种类型是否以及如何统一。具体细节与 Go 实现相关,影响错误消息的具体内容(例如,编译器报告类型推断错误还是其他错误),并可能解释为什么在异常代码情况下类型推断失败。但在编写 Go 代码时,这些规则大多可以忽略:类型推断设计为基本“按预期工作”,统一规则也相应进行了微调。

类型统一由_匹配模式_控制,可能是_精确_或_宽松_。当统一递归下降到复合类型结构时,用于类型元素的匹配模式(元素匹配模式)与匹配模式相同,除非两种类型因可赋值性≡<sub>A</sub>)而统一:在这种情况下,匹配模式在顶层是_宽松_的,但对于元素类型则变为_精确_,反映出类型不必完全相同即可赋值的事实。

如果满足以下任一条件,则两种非绑定类型参数的类型完全统一:

  • 两种类型相同
  • 两种类型具有相同的结构,且其元素类型完全统一。
  • 恰好一种类型是未绑定的类型参数,且其类型集中的所有类型根据 ≡<sub>A</sub> 的统一规则(顶层宽松统一,元素类型精确统一)与另一种类型统一。

如果两种类型都是绑定类型参数,则它们根据给定的匹配模式统一,如果:

  • 两种类型参数相同。
  • 最多一种类型参数具有已知类型参数。在这种情况下,类型参数被_合并_:它们都代表相同的类型参数。如果两种类型参数都还没有已知类型参数,则为一个类型参数推断的未来类型参数同时推断为两种类型参数。
  • 两种类型参数都具有已知类型参数,且类型参数根据给定的匹配模式统一。

单个绑定类型参数 P 和另一种类型 T 根据给定的匹配模式统一,如果:

  • P 没有已知类型参数。在这种情况下,T 被推断为 P 的类型参数。
  • P 确实有已知类型参数 AAT 根据给定的匹配模式统一,并且满足以下条件之一:
    • AT 都是接口类型:在这种情况下,如果 AT 也都是定义类型,则它们必须相同。否则,如果它们都不是定义类型,则它们必须具有相同数量的方法(AT 的统一已确认方法匹配)。
    • AT 都不是接口类型:在这种情况下,如果 T 是定义类型,则 T 替换 A 作为推断的 P 的类型参数。

最后,如果满足以下条件,则两种非绑定类型参数的类型松散统一(并根据元素匹配模式):

  • 两种类型完全统一。
  • 一种类型是定义类型,另一种类型是类型字面值,但不是接口,且其基础类型根据元素匹配模式统一。
  • 两种类型都是接口(但不是类型参数),具有相同的类型项,都嵌入或不嵌入预声明类型comparable,对应方法类型完全统一,且一种接口的方法集是另一种接口方法集的子集。
  • 只有一种类型是接口(但不是类型参数),两种类型的对应方法根据元素匹配模式统一,且接口的方法集是另一种类型方法集的子集。
  • 两种类型具有相同的结构,且其元素类型根据元素匹配模式统一。

On this page

语言版本 go1.26 (2026年1月12日)介绍符号源代码表示字符字母和数字词法元素标记分号标识符关键字运算符和标点符号整数字面量浮点字面量虚数字面量Rune字面量字符串字面量常量变量类型布尔类型数值类型字符串类型数组类型切片类型结构体类型指针类型函数类型接口类型基本接口嵌入接口通用接口实现接口映射类型通道类型类型和值的属性值的表示潜在类型类型标识可分配性可表示性方法集声明和作用域标签作用域空白标识符预声明标识符导出标识符标识符唯一性常量声明Iota类型声明别名声明类型定义类型参数声明类型约束满足类型约束变量声明短变量声明函数声明方法声明表达式操作数限定标识符复合字面量函数字面量基本表达式选择器方法表达式方法值索引表达式切片表达式基本切片表达式完整切片表达式类型断言调用... 参数传递参数实例化类型推断类型统一运算符运算符优先级算术运算符整数运算符整数溢出浮点运算符字符串连接比较运算符逻辑运算符地址运算符接收运算符转换数值类型之间的转换与字符串类型之间的转换切片到数组或数组指针的转换常量表达式求值顺序语句终止语句空语句标记语句表达式语句发送语句自增自减语句赋值语句If 语句Switch 语句表达式 switch类型 switchFor 语句单条件 For 语句带 ForClause 的 For 语句range 子句的 For 语句Go 语句Select 语句返回语句Break 语句Continue 语句Goto 语句Fallthrough 语句Defer 语句内置函数切片追加和复制清除关闭复数操作映射元素删除长度和容量创建切片、映射和通道最小值和最大值分配处理恐慌启动源文件组织包子句导入声明示例包程序初始化和执行零值包初始化程序初始化程序执行错误运行时恐慌系统考虑unsafe大小和对齐保证附录语言版本Go 1.9Go 1.13Go 1.14Go 1.17Go 1.18Go 1.20Go 1.21Go 1.22Go 1.23Go 1.24类型统一规则