0

0

我在暴躁同事小张的胁迫下学会了Go的交叉编译和条件编译

看不見的法師

看不見的法師

发布时间:2025-09-18 08:41:55

|

326人浏览过

|

来源于php中文网

原创

今天继续关于

go
开发经验的分享,这次的主题是关于
go
的交叉编译和条件编译,伴随着我对自己打不过、惹不起的壕同事小张还有运维们的碎碎念。

交叉编译

交叉编译是用来在一个平台上生成另一个平台的可执行程序。比如我工作开发时用的Mac,系统内核是

darwin
,小张用的是外星人,系统内核是
windows
(小张明显比我有钱,我的Mac是公司发的,人家的外星人是为打游戏自己买的)。

那么假如我编写的代码依赖了系统底层平台或处理器架构特性的

go
包时,比如说我上周在文章《Go服务迁到K8s后老抽风重启? 记一次完整的线上问题解决过程》里写的,为了把
go
运行时的
panic
错误重定向到日志文件,我用了
syscall.Dup2
这个函数把标准错误原来的文件描述符替换成了自己指定的日志文件的描述符。
syscall.Dup2
go
语言在类
Unix
系统,
X86_64
架构下才有的函数库,在Mac系统上、各种服务器环境上编译都没有问题,但是唯独在像小张这样不用办公电脑的土豪们用的
windows
系统上编译不过去。

所以在上篇文章说的那个为了追踪在

Kubernetes
上服务老重启的问题,用
syscall.Dup2
重定向标准输出的解决方案是有副作用的,我贴一下之前这个功能的代码。

代码语言:javascript代码运行次数:0运行复制
func RewriteStderrFile() error {   if runtime.GOOS == "windows" {      return nil   }   ......    file, err := os.OpenFile(stdErrFile, os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666)    if err != nil {      fmt.Println(err)        return err    }        if err = syscall.Dup2(int(file.Fd()), int(os.Stderr.Fd())); err != nil {        fmt.Println(err)        return err    }    ......    return nil}

天真的用了一个runtime.GOOS == "windows"的判断,我还想着能在代码里根据内核的不同执行不同的代码,但是

go
的软件包是先编译成可执行文件再执行的,这个判断根本没啥用。所以在
windows
系统下编译项目的时候,因为没有
syscall.Dup2
直接就失败了......。

我这不就是典型的动态语言的思维吗,之前还写文章跟别人讲《如何避免用动态语言的思维写Go代码》......这次打自己脸打的实在有点疼。

虽然项目这个更新已经上线了,但是土壕小张和运维我都惹不起,迫于无奈我就看了看

go
官方的标准库到底是怎么兼容多平台的。

条件编译

我发现在go的每个内置库里都有很多以不停系统名结尾的文件。下面是

go
的os[1]内置库源代码的部分截图:

我在暴躁同事小张的胁迫下学会了Go的交叉编译和条件编译

在有些文件里还有类似下面这样的注释:

代码语言:javascript代码运行次数:0运行复制
// +build aix darwin dragonfly freebsd js,wasm linux netbsd openbsd solarispackage os...

看了些资料后才知道,他们是用于

go
软件包的条件编译[2]的,条件编译的意思就是通过某种方式来指示编译器编译特定代码。

go
不支持宏,不可以像c语言那样使用
#define
来控制是否包含平台相关的特定代码。作为替代,
go
使用构建标签(
build tags
)和代码文件的命名约定来支持
go
软件包的条件编译。

构建标签

构建标签就是上面我说的源代码里的注释:

代码语言:javascript代码运行次数:0运行复制
// +build aix darwin dragonfly freebsd js,wasm linux netbsd openbsd solarispackage os...

需要注意的是,构建标签必须在代码文件里位于

package
声明的上方,并且后跟一个空行。

go
编译一个包时,它会分析包内的每个源码文件并查找构建标签。标签决定了这个源码文件是否被编译。

构建标签遵循以下三个原则:

空格隔开的选项是或(OR)的关系逗号隔开的选项是与(AND)的关系每个选项由字母和数字组成。如果前面加上
!
,则表示反义代码语言:javascript代码运行次数:0运行复制
// +build darwin freebsd netbsd openbsd

上面的例子,表示这个源码文件只会在支持

kqueue
BSD
系统中被编译。

一个源码文件可以包含多个构建标签。构建规则是每个独立规则的逻辑与关系。如下例子表示该文件将在

linux/386
darwin/386
平台才会被编译 。

代码语言:javascript代码运行次数:0运行复制
// +build linux darwin// +build 386

用逻辑表达式表示就是:(linux OR darwin) AND 386。

文件名后缀

第二种条件编译的方法是通过源码文件的文件名实现的。这种方案比构造标签方案更简单。

go/build包的文档有关于命名约定的描述。简单来说,如果文件名包含_GOOS.go后缀,那么这个源码文件只会在对应的平台被编译。其他平台会忽略这个文件。另一种约定是_GOARCH.go。这两种后缀可以组合起来,但要保证顺序,正确的格式是_GOOS_GOARCH.go,错误的格式是_GOARCH_GOOS.go。

音疯
音疯

音疯是昆仑万维推出的一个AI音乐创作平台,每日可以免费生成6首歌曲。

下载

以下是文件名后缀的一些例子:

代码语言:javascript代码运行次数:0运行复制
mypkg_freebsd_arm.go // 只在 freebsd/arm 系统编译mypkg_plan9.go       // 只在 plan9 编译mypkg_darwin.go      // 只在macos 系统编译

源码文件光有后缀是不行的,比如如下文件名:

代码语言:javascript代码运行次数:0运行复制
_linux.go_freebsd_386.go

即使是在Linux或FreeBSD系统,这两个文件也会被忽略,原因是

go/build
包会忽略所有文件名以
.
_
开始的文件。

使用构建标签还是文件名后缀

构建标签和文件名后缀在功能上是重叠的。比如,一个名为

mypkg_linux.go
的文件,再包含构建标签
// +build linux
会显得多余。

通常来说,当只有一个特定平台或体系需要指定时,我们选择文件名后缀的方式。比如:

代码语言:javascript代码运行次数:0运行复制
mypkg_linux.go         // 只在 linux 系统编译mypkg_windows_amd64.go // 只在 windows amd 64位 平台编译

相反,如果你的文件需要指定给多个平台或体系架构使用,或者你需要排除某个特定平台时,我们选择构建标签的方式。比如:

代码语言:javascript代码运行次数:0运行复制
// 在所有类unix平台编译// +build darwin dragonfly freebsd linux netbsd openbsd// 在非Windows平台编译// +build !windows
实践应用

应用环境,我就说下是怎么解决文章开头说的问题让小张大佬平复心情的吧......。

设置条件编译

首先我像下面这样,在包里建了两个源码文件,用来分别存放在

windows
系统和非
windows
系统下使用的
RewriteStderrFile
函数:

代码语言:javascript代码运行次数:0运行复制
project|└───pkg1│   │----rewrite_err_unix.go│   │----rewrite_err_windows.go

因为我们的项目在那几个大佬电脑的

windows
系统上编译和运行的时候都是开发阶段,其他测试上线之类的环境都是
Linux
系统,所以我懒癌发作,直接写了个空函数,毕竟只要能编译运行小张就不会太难为我了。

代码语言:javascript代码运行次数:0运行复制
//rewrite_err_windows.gopackage pkg1func RewriteStdErrLog(topic string) error { return nil}

对于要在服务器上和Mac电脑上编译的源码,跟之前的差不多,只是增加了构建标签:

代码语言:javascript代码运行次数:0运行复制
//+build darwin linuxpackage pkg1......func RewritePanicsToFile(topic string) error {    ......    file, err := os.OpenFile(stdErrFile, os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666)    if err != nil {      fmt.Println(err)        return err    }   if err = syscall.Dup2(int(errFileHandler.Fd()), int(os.Stderr.Fd())); err != nil {      return err   }    ......     return nil}
执行交叉编译

交叉编译的执行就非常简单了,在编译时给go build命令设置

OS
ARCH
参数即可:

比如在Mac 下编译

windows
64位可执行程序,用:

代码语言:javascript代码运行次数:0运行复制
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build main.go

在Mac系统执行完上面的命令就会编译生成软件包在Windows系统上的可执行文件(.exe文件)

如果是

windows
下编译 Mac 64位可执行程序,用:

代码语言:javascript代码运行次数:0运行复制
SET CGO_ENABLED=0SET GOOS=darwinSET GOARCH=amd64go build main.go
总结

事实上,除了用于

.go
的Go源码文件,构建标签和文件名后缀这些条件编译规则可以作用于任何go tool可以编译的源码文件,包括
.c
.s
文件。
go
标准库中,尤其是
runtime
syscall
OS
net
包中包含了大量这种例子。咱们一定要去看看,多学习,尤其是身边有像小张这样又壕又凶的队友的同学们,一定把今天我说的这些都学会......。

参考资料

[1]

os: https://github.com/golang/go/tree/master/src/os

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

397

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

618

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

354

2023.08.02

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

258

2023.08.09

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

600

2023.09.05

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

526

2023.09.20

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

641

2023.09.20

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

601

2023.09.22

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CSS3 教程
CSS3 教程

共18课时 | 4.7万人学习

PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.5万人学习

NumPy 教程
NumPy 教程

共44课时 | 2.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号