Go 是一门对跨平台开发特别友好的语言，天生支持跨平台的编译，能够通过构建约束等方式对不同操作系统、架构采取不同的实现。本文试从开发中常用到的一些代码片段、功能讲起，在编写代码时就有意识地针对跨平台进行适配，而非先在开发平台上实现，在调试时再针对其他平台进行适配，影响开发效率。

在开发前，最好是看一下一些开源的包是如何进行跨平台适配的，例如 fsnotify。另，由于篇幅有限，本文仅考虑 Linux、macOS 及 Windows 这几个在生产中常见的操作系统，Go 实际上支持的系统要更多，一般来说日常开发针对这三个系统足矣。

交叉编译

Go 语言天生支持跨平台编译，只需要在命令行中指定目标平台的操作系统和处理器架构即可。

GOOS=windows GOARCH=amd64 go build

一般来说，打包构建以下平台即可：

全部列表，见链接。darwin 一般而言等价于 macOS，但两者有区别，感兴趣可以看文后链接。

第三方库支持

使用第三方库时，需要确保它们支持目标平台。可以查看库的文档或者 issue 了解支持情况。有些库可能只支持特定平台，需要根据情况选择替代品。

路径

在 Windows 平台上，路径分隔符使用反斜杠 \ （backslashes），而 Linux 和 macOS 使用斜杠 / （slashes）。

解决方案非常简单，一直使用 filepath 包即可。

目录

一般而言，有一些目录是约定俗成的，例如 home 目录、配置目录、缓存目录等，可以通过 os 包获得。

homeDir, _ := os.UserHomeDir()
configDir, _ := os.UserConfigDir()
cacheDir, _ := os.UserCacheDir()

在一些情况下，如果我们希望把文件保存在某一个绝对路径，则需要对不同系统作适配。具体做法是针对操作系统使用不一样的文件，在末尾加上操作系统的名称，加上编译标记。如下：

dir.go

//go:build !windows
var specialDir = "/tmp/this/is/a/dir"

dir_windows.go

//go:build windows
var specialDir = "C:\\some\other\dir"

这样，在编译目标为 Windows 时，变量的值将会是 WIndows 的文件路径。

关于 go 的构建约束更多信息，可以参考文后的链接。

系统调用

Go 的 syscall  包提供了一些常用的系统调用函数。不同操作系统的系统调用可能有所不同,如果需要使用底层系统调用,需要区分目标平台。一个比较简单的解决方案是使用 Go 提供的更高级别的标准库函数，如  os、net  等，它们内部通过调用系统调用来实现功能。

Ref

GitHub - fsnotify/fsnotify: Cross-platform file system notifications for Go.
Build constraints and vendoring | GoLand Documentation
build package - go/build - Go Packages
Why is macOS often referred to as 'Darwin'? - Ask Different