C 函数问题：函数声明与定义不匹配

当编译器抛出 conflicting types for 'function_name' 或链接时出现 undefined reference 错误，通常意味着函数的“承诺”（声明）与“兑现”（定义）不一致。这类问题在大型项目跨文件调用时尤为隐蔽，必须通过严格的排查步骤进行修正。

核心排查步骤

1. 定位 函数声明位置。通常位于 .h 头文件中，或者在调用该函数的 .c 文件顶部。检查 是否存在旧式声明（如 int foo(); 表示参数未知，而非无参数）。
2. 定位 函数定义位置。即函数具体实现的代码块，位于对应的 .c 源文件中。
3. 执行 逐项比对。重点关注 以下三个关键要素，确保声明与定义严丝合缝。

关键要素对比表

将代码中的声明与定义填入下表进行核对，快速锁定差异点。

典型错误修正示例

以下是几种高频错误场景的具体修正方法。

场景一：参数类型不一致

这是最容易被忽略的错误，尤其是指针类型与非指针类型混用。

错误代码：

/* file.h */
void calculate(int data);  // 声明：参数为 int

/* file.c */
void calculate(int* data) { // 定义：参数为 int 指针
    // implementation
}

修正操作：

1. 确定 预期的数据传递方式。如果需要修改原值，参数应为指针。
2. 修改 声明为 void calculate(int* data);，或修改 定义为 void calculate(int data)。

场景二：返回值类型冲突

C 语言中，如果不写返回值类型，旧标准默认为 int，这会导致现代编译器报错。

错误代码：

/* Declaration */
double get_value(void);

/* Definition */
get_value(void) { // 缺少返回值类型，旧标准默认 int
    return 0.0;
}

修正操作：

1. 补全 定义处的返回值类型。
2. 确保 声明与定义完全一致。

正确代码：

double get_value(void) {
    return 0.0;
}

场景三：跨文件作用域问题

如果在 .c 文件中写了函数实现，但忘记包含对应的 .h 头文件，编译器可能根据隐式声明推导出错误的函数签名。

排查流程：

1. 确认 .c 文件开头是否 #include 了对应的 .h 文件。
2. 检查 头文件中是否使用了宏保护（#ifndef），防止重复声明导致的差异。
3. 清理 并重新编译项目。使用 make clean 或清理 IDE 构建缓存，确保旧的中间文件不会干扰判断。

最佳实践：保持同步

为了避免此类不匹配，建议采用以下编码习惯：

1. 复制 头文件中的函数声明行。
2. 粘贴 到源文件中。
3. 删除 末尾的分号 ;。
4. 添加 函数体大括号 { } 并编写逻辑。