APP正在开发中...
返回顶部
您的位置： 主页 > 脚本 > Golang >

收藏
分享到

Go实现完全静态编译和交叉编译的代码

Golang 来源：互联网 作者：佚名 发布时间：2025-08-22 18:08:51 人浏览
摘要

Go 语言天生支持跨平台编译，并且其标准库几乎不依赖系统动态库，所以在大多数场景下，它编译出来的二进制文件几乎可以直接丢到任何机器运行。 但实际开发中，我们经常遇到两个问题：

Go 语言天生支持跨平台编译，并且其标准库几乎不依赖系统动态库，所以在大多数场景下，它编译出来的二进制文件几乎可以直接丢到任何机器运行。

但实际开发中，我们经常遇到两个问题：

  1. 如何完全静态编译？
    • 确保 ldd 显示 not a dynamic executable，不依赖宿主机动态库。
  2. 如何交叉编译到不同平台？
    • 例如 Mac 上编译 Linux/Windows/ARM64 的二进制。

这篇文章会从基础概念讲起，逐步深入，并附带一个一键多平台静态编译脚本，让你少踩坑。

1. 基础概念

1

2

3

• 静态编译 = 把所有依赖库都编进一个二进制，丢到任何机器都能跑

• 动态编译 = 程序运行时还需要宿主机的动态库（如 libc.so.6）

• 交叉编译 = 在 A 平台上编译 B 平台的程序（比如 Mac 编译 Linux 版）

Go 天生适合静态编译，因为：

1

2

• 纯 Go 代码不依赖外部 libc

• 关闭 CGO 后编译结果天然是静态的

只有当项目用了 CGO（如 sqlite、openssl）才会出现动态依赖，需要额外处理。

2. 完全静态编译

纯 Go 项目（最简单）

1

CGO_ENABLED=0 go build -ldflags="-s -w" -o app .

1

2

• CGO_ENABLED=0 关闭 C 依赖 → 天然静态

• -ldflags="-s -w" 去掉符号表，减小体积

验证：

1

ldd app  # not a dynamic executable ?

有 CGO 依赖（sqlite、openssl 等）

默认会动态链接 glibc，要用 musl 完全静态化：

1

CC=musl-gcc CGO_ENABLED=1 go build -ldflags="-linkmode external -extldflags -static" -o app .

1

2

• musl-gcc 是轻量 libc，适合静态链接

• -extldflags -static 让外部链接器打包所有依赖

验证：

1

ldd app  # not a dynamic executable ?

3. 交叉编译（跨平台 + 静态）

Go 内置交叉编译能力，只需 GOOS/GOARCH：

1

2

3

4

5

6

7

8

9

10

11

12

13

# Linux AMD64

GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o app-linux-amd64 .

 

# Linux ARM64（树莓派）

GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o app-linux-arm64 .

 

# Windows

GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o app-windows-amd64.exe

 

# macOS ARM64

GOOS=darwin GOARCH=arm64 CGO_ENABLED=0 go build -o app-mac-arm64

 

?? 如果必须用 CGO，交叉编译就需要额外交叉工具链（如 aarch64-linux-musl-gcc）。

4. Docker 结合静态编译

1

2

•   动态编译的程序 → 容器镜像必须带 libc（debian、alpine）

•   静态编译的程序 → 直接放 FROM scratch，镜像只有几 MB

推荐：

1

2

3

4

5

6

7

8

9

FROM golang:1.22-alpine AS builder

RUN apk add --no-cache build-base musl-dev

WORKDIR /src

COPY . .

RUN CGO_ENABLED=0 go build -ldflags="-s -w" -o /out/app .

 

FROM scratch

COPY --from=builder /out/app /app

ENTRYPOINT ["/app"]

5. 一键多平台静态编译脚本

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

#!/usr/bin/env bash

set -e

 

APP="myapp"         # 你的程序名

OUT="dist"          # 输出目录

PLATFORMS=("linux/amd64" "linux/arm64" "darwin/arm64" "windows/amd64")

 

# 是否启用 CGO（0=纯Go，1=需要C依赖）

USE_CGO=${USE_CGO:-0}

 

echo "???? Building $APP for: ${PLATFORMS[*]}"

echo "???? CGO Mode: ${USE_CGO}"

 

rm -rf "$OUT" && mkdir -p "$OUT"

 

for p in "${PLATFORMS[@]}"; do

  GOOS=${p%/*}

  GOARCH=${p#*/}

 

  BIN="$OUT/$APP-$GOOS-$GOARCH"

  [[ $GOOS == "windows" ]] && BIN="$BIN.exe"

 

  echo -e "\n==> ???? Building for $GOOS/$GOARCH ..."

 

  if [[ "$USE_CGO" == "1" && "$GOOS" == "linux" ]]; then

    echo "   ???? CGO enabled + musl static build"

    CC=musl-gcc \

    CGO_ENABLED=1 \

    GOOS=$GOOS GOARCH=$GOARCH \

    go build -ldflags="-linkmode external -extldflags -static -s -w" -o "$BIN" .

  else

    echo "   ? Pure Go build (CGO disabled)"

    CGO_ENABLED=0 GOOS=$GOOS GOARCH=$GOARCH \

    go build -ldflags="-s -w" -o "$BIN" .

  fi

 

  # ? 验证是否静态（仅 Linux）

  if [[ "$GOOS" == "linux" && -x "$BIN" ]]; then

    echo "   ???? Checking binary type:"

    if command -v ldd >/dev/null; then

      ldd "$BIN" || echo "? Not a dynamic executable"

    else

      echo "   (ldd not found, skip check)"

    fi

  fi

 

  echo "   ? $BIN built."

done

 

echo -e "\n???? All binaries are in $OUT/"

执行：

1

2

chmod +x build-all.sh

./build-all.sh # or USE_CGO=1 ./build-all.sh

最终你会得到:

1

2

3

4

5

6

dist/

  ├── myapp-linux-amd64

  ├── myapp-linux-arm64

  ├── myapp-darwin-amd64

  ├── myapp-darwin-arm64

  ├── myapp-windows-amd64.exe

可以分发给对应的二进制平台即可

其他:

musl 是 一个轻量的 C 标准库实现，主要用来替代传统的 glibc。

Go 编译器在用 CGO 时，需要链接 C 运行库（libc），默认是 glibc，但 glibc 的动态库在不同 Linux 发行版版本不同，容易产生兼容性问题。

musl 的特点是：

1

2

3

4

•   体积小（适合嵌入式和容器）

•   设计简洁、依赖少

•   支持完整静态链接，方便做“丢哪都能跑”的程序

•   常用在 Alpine Linux 这种极简系统中

所以，如果你想让一个含 CGO 的 Go 程序 完全静态，就得用 musl-gcc 替代 gcc，这样 libc 也能被编进二进制里。

glibc vs musl 直观对比

项目 glibc musl
体积 大 小
兼容性 最通用，几乎所有 Linux 默认用 轻量，偏向容器/嵌入式
默认是否动态链接 ? ?
是否易做静态编译 ? 麻烦 ? 非常容易
适用场景 桌面、服务器 Alpine、scratch 镜像、IoT

版权声明 : 本文内容来源于互联网或用户自行发布贡献，该文观点仅代表原作者本人。本站仅提供信息存储空间服务和不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权， 违法违规的内容， 请发送邮件至2530232025#qq.cn(#换@)举报，一经查实，本站将立刻删除。

您可能感兴趣的文章 :

原文链接 :
相关文章
  • Go实现完全静态编译和交叉编译的代码
    Go 语言天生支持跨平台编译，并且其标准库几乎不依赖系统动态库，所以在大多数场景下，它编译出来的二进制文件几乎可以直接丢到任何

  • Go语言编译环境设置教程

    Go语言编译环境设置教程
    Go语言优势 天生支持高并发 可以自由的去控制其并发量，也就是携程，通过go routine关键字就行了。 自动垃圾回收机制 内存的清理 不需要环
  • Go fmt包中Scan获取标准输入方式
    Go fmt包下有三个函数 可以在程序运行过程中获取用户输入。 fmt.Scan：获取输入 fmt.Scanf：获取输入，但是可以指定格式，go会根据格式解析参
  • go中空接口的具体使用
    接口-空接口 1. 什么是空接口？ 空接口是特殊形式的接口类型，普通的接口都有方法，而空接口没有定义任何方法口，也因此，我们可以说

  • 快速解除oracle dataguard的方法

    快速解除oracle dataguard的方法
    有些时候，我们为了使oracle dg的standby库另做他用，需要解除oracle dataguard数据同步。我本地因为standby库存储出现故障，导致dg存在问题，故需
  • Go 1.23中Timer无buffer的实现方式介绍
    在 Go 1.23 中，Timer 的实现通常是通过 time 包提供的 time.Timer 类型来实现的。Timer 是一个用于在指定时间后触发一次事件的计时器。Timer 的实
  • golang之 wire 库的使用介绍
    1. 写在最前面 之前 review 其他人的代码的时候，看到了关于 wire 库的使用。但当时主要是分析逻辑上的问题，没怎么太学习 wire 库的用法，
  • golang panic 函数用法介绍
    在 Go 语言中，panic和recover是用于处理运行时异常的关键字。以下是它们的用法总结和示例： 1. panic 的作用 触发条件：当程序遇到无法恢复
  • Go中sync.Once源码的深度介绍
    概念 sync.Once是Go语言标准库中的一个同步原语，用于确保某个操作只执行一次。它在多线程环境中非常有用，尤其是在需要初始化共享资源

  • 基于Go语言实现一个压测工具

    基于Go语言实现一个压测工具
    整体架构 整体系统架构比较简单 通用数据处理模块 Http请求响应数据处理 本项目支持http协议、websocket协议、grpc协议、Remote Authentication Di
推荐阅读
最新更新
友情链接
  • 本站所有内容来源于互联网或用户自行发布，本站仅提供信息存储空间服务，不拥有版权，不承担法律责任。如有侵犯您的权益，请您联系站长处理！
  • Copyright © 2017-2022 F11.CN All Rights Reserved. F11站长开发者网 版权所有 | 苏ICP备2022031554号-1 | 51LA统计