go 的 `cgo` 机制默认仅自动编译包根目录下的 c/c++ 源文件，不支持直接通过 `// #cgo` 伪指令递归或显式包含子目录中的 c 文件；需通过分包封装、独立构建或显式链接方式实现跨目录 c 代码集成。
Go 工具链对 C 代码的集成设计以“轻量便捷”为原则：当启用 cgo（即源文件中包含 import "C"）时，go build 会自动识别并编译当前 Go 包目录下的 .c、.cc、.cpp、.m、.s 等源文件，并将其与 Go 代码一并链接。但该行为不递归扫描子目录，且 // #cgo 伪指令（如 // #cgo CFLAGS: 或 // #cgo LDFLAGS:）本身无法指定源文件路径或触发子目录编译——它仅用于传递编译器/链接器标志、头文件搜索路径或静态库依赖。
因此，若需使用子目录（如 ./csrc/ 或 ./vendor/libxyz/src/）中的 C 文件，有以下三种可行路径：
✅ 方案一：拆分为独立 Go 包（推荐用于模块化封装）
将子目录组织为一个独立的 Go 包（含 cgo 和其 C 文件），并在主包中导入调用：
myproject/
├── main.go # import "./cwrapper"
└── cwrapper/
├── wrapper.go # import "C"; // #include "impl.h"
└── impl.c # 实现逻辑（位于子目录内）cwrapper/wrapper.go 示例：
package cwrapper
/*
#cgo CFLAGS: -I.
#include "impl.h"
*/
import "C"
func DoWork() int {
return int(C.do_work())
}⚠️ 注意：impl.c 必须与 wrapper.go 同处 cwrapper/ 目录下，且该目录需为合法 Go 包（含 go.mod 或位于 $GOPATH 中）。
✅ 方案二：预编译为静态库 + 显式链接
手动编译子目录 C 代码为静态库（如 libmycore.a），再通过 // #cgo LDFLAGS 链接：
// main.go /* #cgo CFLAGS: -I./csrc #cgo LDFLAGS: -L./csrc -lmycore #include "csrc/api.h" */ import "C"
执行构建前需确保：
- ./csrc/libmycore.a 已存在（可通过 gcc -c -o csrc/core.o csrc/core.c && ar rcs csrc/libmycore.a csrc/core.o 生成）；
- 头文件路径 -I./csrc 正确指向 api.h 所在位置。
✅ 方案三：使用外部构建系统（适合复杂项目）
对大型 C 依赖（如 OpenSSL、SQLite），建议脱离 go build 自动编译流程，改用 Makefile 或 CMake 构建目标库，再通过 CGO_LDFLAGS 和 CGO_CFLAGS 注入环境变量控制链接行为。
? 关键总结：
- cgo 不是通用构建工具，其自动编译能力严格限定于单个 Go 包根目录；
- 不存在 // #cgo SOURCES: ./subdir/*.c 类伪指令——该语法无效；
- 子目录 C 代码必须通过包隔离、预编译链接或外部构建协同方式集成；
- 生产环境建议优先采用方案一（清晰、可测试、符合 Go 工程规范）或方案三（可控性强、便于调试）。
