CGO_ENABLED=1必须显式启用，否则import "C"会静默失效；需确保系统已安装gcc等C编译器，且路径正确；最小可运行示例要求注释、import "C"、Go代码间无空行，并用CGO_ENABLED=1 go run执行。
CGO_ENABLED=1 必须显式启用，否则 import "C" 会静默失效——这不是警告，是编译器直接跳过 cgo 处理。
确认 C 编译器可用且被 Go 识别
Go 不自带 C 编译器，cgo 实际调用系统上的 gcc（Linux/macOS）或 gcc/clang（Windows via MinGW-w64/MSYS2）。不装编译器，go build 会报错类似：exec: "gcc": executable file not found in $PATH。
- Linux：运行
gcc --version确认已安装；如无，用sudo apt install build-essential（Debian/Ubuntu）或sudo dnf groupinstall "Development Tools"（Fedora） - macOS：运行
xcode-select --install安装命令行工具；若已有 Xcode，确保选中 Command Line Tools - Windows：推荐安装 MSYS2，然后在 MSYS2 shell 中运行
pacman -S mingw-w64-x86_64-gcc；之后务必在该 shell 中执行go build，而非 PowerShell/CMD
写一个能跑通的最小 cgo 示例
别一上来就链接外部库。先验证环境是否真正打通：嵌入 C 函数并调用。
- 新建
main.go，内容严格按此顺序（注释、import "C"、Go 代码，三者间**不能有空行**）：
package main
<p>/*</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill6460" title="Golang Naming"><img
src="https://img.php.cn/upload/skill/000/000/081/179094616043400.jpg" alt="Golang Naming" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill6460" title="Golang Naming">Golang Naming</a>
<p>Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。</p>
</div>
<a href="/xiazai/skill6460" title="Golang Naming" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">go语言免费学习笔记（深入）</a>”；</p><h1>include <stdio.h></h1><p>int add(int a, int b) {
return a + b;
}
*/
import "C"
import "fmt"</p><p>func main() {
res := C.add(2, 3)
fmt.Println(int(res))
}- 关键点：
/* ... */必须紧贴import "C"上方，中间无空行；C.add返回的是C.int，需转为 Go 的int才能传给fmt.Println - 运行：
CGO_ENABLED=1 go run main.go；若输出5，说明 cgo 环境已通
链接外部 C 静态库（.a）时的常见陷阱
想复用现有 C 库？静态链接最可控，但路径和符号必须精确匹配。
-
#cgo LDFLAGS中的-L路径必须是**绝对路径或相对于源文件的相对路径**；${SRCDIR}是安全变量，代表当前 .go 文件所在目录，例如：// #cgo LDFLAGS: -L${SRCDIR}/lib -lmylib - 库名规则：链接
libmylib.a时，写-lmylib（去掉lib前缀和.a后缀）；但若库名是mylib.a（无lib前缀），则必须用完整路径：-L./lib -l:mylib.a - 头文件路径：
#cgo CFLAGS: -I./include；若头文件里有#include "foo.h"，确保foo.h在./include/foo.h - 链接失败报
undefined reference to 'xxx'？不是函数没定义，而是：-lmylib写在了-I之前，或库本身依赖其他库（比如用了pthread），需一并加到LDFLAGS里
导出 Go 函数供 C 调用（c-archive / c-shared）
生成供 C 程序调用的库时，//export 注释和签名限制是硬性门槛，违反即链接失败。
-
//export必须顶格写，前面**不能有空格或 tab**，后面跟函数名，例如：//export MyAdd；写成// export MyAdd或//export MyAdd都无效 - 函数参数和返回值只能是 C 兼容类型：
C.int、*C.char、C.size_t；禁止出现string、[]byte、struct、map；string必须用C.CString转，且调用方负责释放 -
main()函数必须存在但**不能有逻辑体**，只写func main() {}；否则-buildmode=c-archive会报错 - 动态库（
c-shared）在 macOS 上默认禁用；Linux 上若用net、http、time.Now()等，会引入runtime.xxx符号，导致 C 端dlopen失败——纯计算函数才稳妥
实际构建 libcalc.a 时，最容易卡在头文件路径拼错或 -l 名称与文件名不一致；而导出函数时，90% 的问题来自把 //export 当普通注释处理，或者忘了删掉 main 里的业务代码。
