0

0

CGO 项目手动编译流程详解

碧海醫心

碧海醫心

发布时间:2025-08-21 14:42:34

|

298人浏览过

|

来源于php中文网

原创

CGO 项目手动编译流程详解

本文深入解析了在不依赖make等构建#%#$#%@%@%$#%$#%#%#$%@_20dc++e2c6fa909a5cd62526615fe2788a的情况下,CGO项目的底层编译流程。通过剖析make命令的实际输出,详细阐述了CGO源码预处理、Go和C代码的独立编译、C代码的中间链接、动态导入信息的生成,以及最终Go归档文件的打包过程。掌握这些核心步骤,有助于开发者更好地理解CGO的工作机制,并为自定义构建工具提供指导。

CGO 手动编译流程概览

cgo 允许 go 程序调用 c 代码,反之亦然。虽然 go build 命令通常会自动化这个过程,但在某些特定场景下,例如使用自定义构建系统时,理解其底层编译步骤变得至关重要。cgo 的编译过程并非单一工具完成,而是 go 工具链与系统 c/c++ 编译器(如 gcc)协同工作的多阶段流程。

以下是 CGO 项目从 Go 源代码到最终可执行文件(或库)的关键步骤:

  1. CGO 预处理: cgo 工具解析 Go 源码中的 import "C" 部分,生成 Go 兼容的 C 代码、C 兼容的 Go 代码以及其他辅助文件。
  2. Go 代码编译: 使用 Go 编译器(go tool compile)编译 Go 源文件(包括 CGO 生成的 Go 文件)。
  3. C 代码编译: 使用系统 C 编译器(如 gcc)编译 C 源文件(包括 CGO 生成的 C 文件和用户提供的 C 源文件)。
  4. C 代码中间链接: 将所有编译好的 C 对象文件链接成一个中间静态库或目标文件。
  5. 动态导入信息生成: cgo 工具再次介入,从 C 侧的中间链接结果中提取动态导入所需的信息,并生成 Go 工具链可处理的 C 源文件。
  6. 动态导入 C 代码编译: Go 编译器(或其内部的 C 编译器)编译动态导入相关的 C 源文件。
  7. Go 归档打包: 将所有 Go 对象文件和 C 对象文件(或其Go兼容形式)打包成一个 Go 归档文件(.a)。
  8. 最终 Go 程序链接: Go 链接器(go tool link)将 Go 归档文件与 Go 运行时库链接,生成最终的可执行文件。

接下来,我们将详细解析每个步骤及其涉及的文件。

核心步骤解析

以下步骤基于 make 在 32 位 Linux 环境下编译 misc/cgo/life 项目的输出,并映射到现代 Go 工具链的概念。

1. CGO 预处理阶段

这是 CGO 编译的第一步,由 cgo 工具完成。它负责解析 Go 源文件中的 CGO 指令,并生成 Go 和 C 语言之间的桥接代码。

命令示例:

rebuild库存生产管理系统3.9.5
rebuild库存生产管理系统3.9.5

rebuild是一款高度可配置化的企业管理系统!可免费商用!低代码/零代码快速搭建企业中台、OA办公自动化、CRM客户关系管理、WMS库存管理、TMS运输管理、SCM供应链管理,甚至是 ERP 企业资源计划!REBUILD 侧重于业务需求实现,而非基础技术框架或项目启动模板,通过 REBUILD 可以真正实现零代码快速搭建,无需编程、无需编译代码,甚至无需了解技术。 使用开始使用 REBUIL

下载
cgo -- life.go

说明:cgo 命令会读取 life.go 文件,识别其中的 import "C" 块和 C 函数调用/Go 函数导出,然后生成一系列中间文件。

生成文件及其作用:

  • _obj/life.cgo1.go: 包含 Go 代码,用于调用 C 函数或处理 C 类型。
  • _obj/life.cgo2.c: 包含 C 代码,通常是 Go 函数的 C 包装器,或 C 函数的 Go 包装器。
  • _obj/_cgo_gotypes.go: 包含 C 类型在 Go 中的对应定义。
  • _obj/_cgo_defun.c: 包含 CGO 内部使用的 C 函数定义。
  • _obj/_cgo_main.c: CGO 运行时所需的 C 入口点或初始化代码。
  • _obj/_cgo_export.c: 包含将 Go 函数导出到 C 所需的 C 代码。
  • _cgo_export.h: 对应 _cgo_export.c 的头文件,供 C 代码调用 Go 函数时使用。
  • _obj/_cgo_flags: 包含 CGO 编译和链接所需的标志信息,供后续 Go 工具链使用。

2. Go 侧代码编译阶段

此阶段使用 Go 编译器编译 CGO 生成的 Go 源文件,以及部分由 CGO 生成但需要 Go 工具链处理的 C 源文件。

命令示例:

# 编译 cgo 生成的 Go 文件
go tool compile -o _go_.o _obj/life.cgo1.go _obj/_cgo_gotypes.go

# 编译 cgo 生成的、由 Go 工具链处理的 C 文件
# 注意:在较旧的 Go 版本中是 8c,现代 Go tool compile 也能处理 C 文件
go tool compile -o _cgo_defun.o _obj/_cgo_defun.c

说明:

  • go tool compile 是 Go 语言的编译器,它将 Go 源代码编译成 Go 对象文件(通常是 .o 扩展名)。
  • _obj/life.cgo1.go 和 _obj/_cgo_gotypes.go 是 CGO 预处理阶段生成的 Go 代码。
  • _obj/_cgo_defun.c 是 CGO 生成的 C 代码,但 Go 工具链会将其编译成 Go 兼容的对象文件,以便与 Go 代码链接。

3. C 侧代码编译阶段

此阶段使用系统 C 编译器(如 GCC)编译所有纯 C/C++ 源文件,包括用户提供的 C 源文件和 CGO 生成的 C 源文件。

命令示例:

# 编译 cgo 生成的 C 文件
gcc -m32 -I . -g -fPIC -O2 -o _cgo_main.o -c _obj/_cgo_main.c
gcc -m32 -I . -g -fPIC -O2 -o life.cgo2.o -c _obj/life.cgo2.c
gcc -m32 -I . -g -fPIC -O2 -o _cgo_export.o -c _obj/_cgo_export.c

# 编译用户提供的 C 文件 (例如本例中的 c-life.c)
gcc -m32 -g -fPIC -O2 -o c-life.o -c c-life.c

说明:

  • gcc -c 命令用于将 C 源文件编译成目标文件(.o)。
  • -m32: 指定生成 32 位代码。
  • -I .: 添加当前目录到头文件搜索路径。
  • -g: 生成调试信息。
  • -fPIC: 生成位置无关代码,常用于共享库。
  • -O2: 优化级别。
  • 这些 C 对象文件将在后续步骤中被链接。

4. C 侧中间链接阶段

将所有由 GCC 编译生成的 C 对象文件链接成一个中间目标文件或静态库。

命令示例:

gcc -m32 -g -fPIC -O2 -o _cgo1_.o _cgo_main.o c-life.o life.cgo2.o _cgo_export.o

说明:

  • 这个 _cgo1_.o 文件包含了所有 C 侧的函数实现和符号,是 Go 运行时与 C 代码交互的基础。

5. 动态导入信息生成阶段

cgo 工具再次被调用,这次是为了从 C 侧的中间链接结果中提取动态链接所需的信息,并生成一个 C 源文件。

命令示例:

cgo -dynimport _cgo1_.o >_obj/_cgo_import.c_ && mv -f _obj/_cgo_import.c_ _obj/_cgo_import.c

说明:

  • -dynimport 参数指示 cgo 工具分析 _cgo1_.o 文件,生成包含动态导入符号信息的 C 代码。
  • _obj/_cgo_import.c 文件将包含 Go 运行时在加载 C 库时需要解析的符号表信息。

6. 动态导入 C 代码编译阶段

将上一步生成的 _cgo_import.c 文件编译成 Go 兼容的对象文件。

命令示例:

# 同样,在较旧的 Go 版本中是 8c,现代 Go tool compile 也能处理 C 文件
go tool compile -o _cgo_import.o _obj/_cgo_import.c

说明:

  • 这个对象文件包含了 Go 运行时进行动态链接的关键数据。

7. Go 归档打包阶段

将所有 Go 对象文件和 C 对象文件(或其 Go 兼容形式)打包成一个 Go 归档文件(.a)。这个归档文件是 Go

相关专题

更多
磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

1345

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

698

2023.06.29

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

293

2023.06.30

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

773

2023.07.05

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

571

2023.07.06

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

544

2023.07.20

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

296

2023.07.20

linux查看cpu使用率
linux查看cpu使用率

在linux的系统维护中,可能需要经常查看cpu使用率,分析系统整体的运行情况。本专题为大家带来了linux查看cpu使用率的相关文章,感兴趣的朋友千万不要错过了。

374

2023.07.25

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

7

2025.12.31

热门下载

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

精品课程

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

共48课时 | 6.3万人学习

Git 教程
Git 教程

共21课时 | 2.3万人学习

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

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