c函数调用失败主因是cgo未识别c代码：import "c"前的/ /块须紧贴、无空行、无go语句；c.cstring需配对c.free；结构体传参须用c.struct_xxx和指针；链接失败因声明与实现分离，需内联实现或正确配置外部库。
C 函数调用失败，90% 是 cgo 根本没看到你的 C 代码，不是语法错，是位置或格式错。
import "C" 前的 /* */ 块必须紧贴、无空行、无 Go 语句
cgo 只解析紧挨 import "C" 上方、且用 /* */ 包裹的注释块。任何偏差都会让整块 C 代码“消失”——undefined: C.xxx 就是典型症状。
- ✅ 正确：
/* #include <stdio.h> int f() { return 42; } */</stdio.h>然后换行写import "C" - ❌ 错误：中间有空行、前面有
//注释、或上面写了var x = 1——cgo 直接跳过 - ❌ 错误：用
// #include <stdio.h></stdio.h>——cgo 完全不识别单行注释里的 C 内容 - ⚠️ 注意：
import "C"必须独占一行，不能和别的import合并，也不能加注释
C.CString 和 C.free 必须严格配对，且不能跨函数生命周期持有
Go 字符串底层是只读 slice，C 函数接收 char* 后若缓存指针、异步访问或长期持有，GC 一触发就可能读到野地址——崩溃或乱码。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
-
C.CString(s)调用malloc分配新内存、复制内容、加\0，返回*C.char - 必须显式配对
C.free(unsafe.Pointer(ptr))；defer只保函数退出释放，不保异步安全 - 若 C 函数返回静态字符串（如
return "ok";），用C.GoString(cstr)转 Go 字符串即可，cstr不用free - 若 C 函数返回
malloc出来的字符串，Go 层必须自己C.free，别指望 C 函数帮你释放
结构体和数组传参必须用 C.struct_xxx 和指针，不能手写模拟
Go 的 struct 和 C 的 struct 内存布局规则完全不同：字段顺序、填充、对齐、int/long 位宽都由各自编译器决定。跨平台尤其危险。
- 一律用
C.struct_name（cgo 自动生成），字段名和类型直接从 C 头文件推导 - 传结构体给 C 函数时，必须传指针：
&p，不能传值p（C 函数收不到修改） - 数组要传首元素地址：
&arr[0]，不能直接传arr（Go 不允许取数组变量地址） - 别手写 Go
struct模拟 Cstruct，也别用unsafe.Offsetof算偏移——它反映的是 Go 布局，不是 C 的
链接失败（undefined reference）本质是头文件声明 ≠ 实现存在
undefined reference to 'sumUp' 表示 cgo 看到了声明（比如在 #include "math.h" 里），但链接时找不到定义。cgo 不会自动编译同目录下的 .c 文件。
- 内联方式：把实现也写进
/* */块里，例如/* #include <stdio.h>\nint sumUp(int a, int b) { return a + b; } */</stdio.h> - 独立
.c文件：必须和.go同包路径，且不能重名冲突（如math.go和math.c可共存） - 预编译库：配
// #cgo LDFLAGS: -L/path/to/lib -lmath，确保libmath.a是目标平台 ABI 编译的 - 交叉编译时务必设
CGO_ENABLED=1，并指定对应平台的CC工具链，否则静态库格式不匹配会报file not recognized
最常被忽略的是：C 代码块里漏了 #include 所依赖的全部头文件（比如 stdlib.h），或者用了 C++ 风格声明却没加 extern "C"。这些不会报语法错，但符号就是不见。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
