CGO未编译同目录C文件求助：出现链接错误

我之前也踩过这个CGO的坑！官方文档说会自动编译同目录下的C文件，但实际跑起来却报链接错误，大概率是几个细节没注意到，咱们来逐个排查解决：

先确认基础文件结构 #

首先你得确保文件结构是标准的同目录布局，比如：

./
├── myTest.go
├── myTest.h
└── myTest.c

如果C文件或者头文件放在子目录里，CGO默认不会自动扫描，得手动指定编译参数，但你说的是同目录，所以先确认文件都在同一层级。

常见问题与解决方案 #

1. 文件名大小写不匹配（区分大小写系统必看） #

如果你用的是Linux/macOS这类区分大小写的系统，CGO对文件名大小写非常敏感。比如头文件是myTest.h，但C文件叫mytest.c（全小写），这时候CGO会找不到对应的C文件，自然不会编译。一定要保证C文件和头文件的命名完全匹配（包括大小写）。

2. 显式开启CGO编译 #

有时候CGO会被默认关闭（比如交叉编译或者某些环境变量配置），编译的时候要显式开启CGO：

CGO_ENABLED=1 go build

或者直接在目录下执行go build（不带单个文件名），让Go自动扫描所有相关源文件：

# 不要只编译单个go文件，让Go处理所有依赖
go build

3. 头文件声明与C文件实现不匹配 #

看起来像是没编译C文件，但有时候其实是函数声明和实现不匹配，导致链接时找不到正确的符号。比如你的myTest.h必须包含print_str的正确声明：

#ifndef MYTEST_H
#define MYTEST_H
// 声明要和C文件里的实现完全一致
void print_str(const char* s);
#endif

对应的myTest.c实现要对应：

#include "myTest.h"
#include <stdio.h>

void print_str(const char* s) {
    printf("%s", s);
}

4. Go模块的潜在影响 #

如果你的项目在Go模块下（有go.mod文件），偶尔会出现模块机制忽略C文件的情况。可以试试重新初始化模块：

# 删除现有模块文件（备份后操作）
rm go.mod go.sum
# 重新初始化模块
go mod init mytest
# 再次编译
go build

完整可运行示例 #

给你一个完整的可运行代码示例，你可以对照自己的文件调整：

myTest.h

#ifndef MYTEST_H
#define MYTEST_H

void print_str(const char* s);

#endif

myTest.c

#include "myTest.h"
#include <stdio.h>

void print_str(const char* s) {
    printf("%s", s);
}

myTest.go

package main

/*
#include <stdlib.h>
#include "myTest.h"
*/
import "C"
import "unsafe"

func Print(s string) {
    cs := C.CString(s)
    C.print_str(cs)
    C.free(unsafe.Pointer(cs))
}

func main() {
    str1 := "hi how are you\n"
    Print(str1)
}

编译运行：

CGO_ENABLED=1 go build
./mytest

这样应该就能正常输出内容了。

内容的提问来源于stack exchange，提问作者Kanwar Saad