Arduino框架下C++调用C函数出现“C/C++链接声明冲突”编译错误

看起来你遇到的核心问题是C++编译器对函数名的修饰规则和C不一致，导致链接时无法匹配到C文件中定义的函数。我们来一步步拆解解决：

问题根源 #

你的GuiLib.h头文件里的GuiLib_ShowScreen声明没有用extern "C"包裹，所以当C编译器包含这个头文件时，会默认按照C的名字修饰规则处理该函数（比如添加额外的参数类型信息到函数名中）。但函数实际是在.c文件中用C编译器编译的，名字修饰方式完全不同，最终链接器就会报错说"声明冲突"。

解决方案一：修改原头文件（推荐） #

如果可以修改GuiLib.h，直接把所有C函数的声明用条件编译的extern "C"块包裹，这样C和C++编译器都能正确识别：

#ifndef GUILIB_H
#define GUILIB_H

// 先保留原有的类型定义，比如GuiConst_INT16U、GuiConst_INT16S等

#ifdef __cplusplus
extern "C" {
#endif

// 这里放所有C函数的声明
extern void GuiLib_ShowScreen(const GuiConst_INT16U StructureNdx, GuiConst_INT16S CursorFieldToShow, GuiConst_INT8U ResetAutoRedraw);
// 其他C函数声明...

#ifdef __cplusplus
}
#endif

#endif // GUILIB_H

解决方案二：无法修改原头文件时的替代方案 #

如果GuiLib.h是第三方库不能修改，那就在你的display_driver.h中调整头文件的包含方式，用extern "C"包裹对GuiLib.h的包含，强制让编译器把里面的函数都当作C链接处理：

#ifndef _DISPLAY_DRIVER_H_
#define _DISPLAY_DRIVER_H_
#include <TFT_eSPI.h>
#include <SPI.h>
#include <ac.h>
#include <stdio.h>

// 关键：先开启C链接，再包含GuiLib.h
#ifdef __cplusplus
extern "C" {
#endif
#include "gui/GuiLib.h"
#ifdef __cplusplus
}
#endif

#define USE_DMAA_TO_TFT

// 注意：这里不需要再重复声明GuiLib_ShowScreen了，已经从GuiLib.h中引入
class display_ {
public:
    TFT_eSPI tft;
    bool getStatus();
    void initPWM();
    void writePWM(int duty);
};
#endif

为什么你之前的尝试没生效？ #

你之前在display_driver.h里单独声明了一次带extern "C"的GuiLib_ShowScreen，但此时GuiLib.h里已经有一个不带extern "C"的声明了——编译器看到两个同一函数的声明，一个是C++链接，一个是C链接，自然会报"冲突"。正确的做法是让所有该函数的声明都统一为C链接，而不是重复声明。

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