go程序中同一个包下为什么会存在多个同名的函数或变量

目录

背景

一探究竟

增加构建约束 & 不同格式的构建约束

背景

首先，这种情况显然是不符合编译规则的，我们都知道在同一个包下出现两个同名的函数、变量、常量等会编译不通过，那么怎么还会有这种现象存在？

如下，源码中任意找一个有这种现象的包：

一探究竟

既然都是go代码，肯定是适配同一套逻辑的。

创建一个测试项目，创建一个包pkg，分别创建如下文件：

我们让mypkg包下的所有文件中都有GetPackageName函数（返回的值不同）、flag变量。

注意，这些文件目前并未提示redeclared。

然后main中调用GetPackageName函数。

在运行之前，编译器并没有显式的报错。接着go build，编译正常。运行结果输出了：

mypkg from windows

交叉编译一下Linux平台，运行：

mypkg from linux

看起来编译时自动找到对应文件处理了。

继续。

在mypkg包下接着新建一个名为openbsd.go的文件，和上述文件的函数保持同名，然后很明显的报错出来了：'GetPackageName' redeclared in this package

条件不变，且在pkg_windows.go文件已存在的前提下：

继续创建名为_openbsd.go的文件，没有报错。

继续创建名为pkg_amd64.go、pkg_x64.go、pkg_x86.go、othername_amd64.go等文件均会提示redeclared。

但创建的othername_arm64.go、pkg_linux_amd64.go、pkg_linux_arm64.go不会提示。

对于linux的两个文件，这里看着没毛病，实际上在linux、amd64平台上编译就会报错：

mypkg\pkg_linux_amd64.go:4:2: flag redeclared in this block

        mypkg\pkg_linux.go:4:2: other declaration of flag

mypkg\pkg_linux_amd64.go:7:6: GetPackageName redeclared in this block

        mypkg\pkg_linux.go:7:6: other declaration of GetPackageName

是因为pkg_linux_amd64.go文件和pkg_linux.go文件的同名内容冲突了，在linux、amd64平台上编译，这两文件就会被适配到。

如果目标平台改为linux、arm64进行编译，也会报：

mypkg\pkg_arm64.go:4:2: flag redeclared in this block

        mypkg\othername_arm64.go:4:2: other declaration of flag

mypkg\pkg_arm64.go:7:6: GetPackageName redeclared in this block

        mypkg\othername_arm64.go:7:6: other declaration of GetPackageName

mypkg\pkg_linux.go:4:2: flag redeclared in this block

        mypkg\othername_arm64.go:4:2: other declaration of flag

mypkg\pkg_linux.go:7:6: GetPackageName redeclared in this block

        mypkg\othername_arm64.go:7:6: other declaration of GetPackageName

是因为othername_arm64.go文件、pkg_arm64.go和pkg_linux.go文件的同名内容冲突了，在linux、arm64平台上编译，这三个文件就会被适配到。

综合来看：

1，类似约定xxx_windows.go、xxx_arm64.go、xxx_linux_arm64.go命名的文件用于实现平台特定的代码。

2，编译器自动认识以_系统/arch名称结尾的go文件。

3，编译时，GOOS 和 GOARCH都可以在文件名上来做构建约束，go编译器会根据当前操作系统自动选择匹配的文件进行编译。

增加构建约束 & 不同格式的构建约束

例如，针对不同的系统、架构的代码文件做相同的事情，我们可以进行编译约束：

即，顶部增加如下格式的约束（不能漏掉注释）：

//go:build arm64 && freebsd

如下格式仅针对特定操作系统：

//go:build freebsd

如下格式针对特定的多个系统均可：

//go:build aix || darwin || freebsd || linux

如下格式的文件支持在linux系统、但不能在arm或arm64架构下进行编译

//go:build linux && !arm && !arm64

感叹号表示“非”。

以上是go 1.17及以上版本引入的格式，定义了一个布尔表达式，包含了逻辑运算符，条件可以更复杂。

与此不同，下面的格式是go 1.17以下支持的约束格式：

// +build freebsd

也会有两种格式并存的情况：

//go:build linux
// +build linux

因为也有环境是老编译器的情况，老版本的编译器不能识别新的约束语法。

go语言支持的系统和架构列表

#go tool dist list

aix/ppc64

android/386

android/amd64

android/arm

android/arm64

darwin/amd64

darwin/arm64

dragonfly/amd64

freebsd/386

freebsd/amd64

freebsd/arm

freebsd/arm64

freebsd/riscv64

illumos/amd64

ios/amd64

ios/arm64

js/wasm

linux/386

linux/amd64

linux/arm

linux/arm64

linux/loong64

linux/mips

linux/mips64

linux/mips64le

linux/mipsle

linux/ppc64

linux/ppc64le

linux/riscv64

linux/s390x

netbsd/386

netbsd/amd64

netbsd/arm

netbsd/arm64

openbsd/386

openbsd/amd64

openbsd/arm

openbsd/arm64

openbsd/ppc64

plan9/386

plan9/amd64

plan9/arm

solaris/amd64

wasip1/wasm

windows/386

windows/amd64

windows/arm

windows/arm64