VS Code用G++编译C/C++混写的wxWidgets项目出现未定义引用报错

问题原因 #

你的构建报错属于典型的链接阶段符号找不到问题，由两个独立原因共同导致：

1. Debug构建配置未加入C源文件：对比你的Debug和Release任务参数可以发现，Release任务明确列出了所有C源文件，而Debug任务仅编译了*.cpp后缀的C++文件，C文件的函数实现没有被编译进最终程序，自然无法找到对应符号。
2. C与C混合编译的符号不匹配：C编译器会对函数名做名字修饰以支持重载等特性，而C编译器无此逻辑，C++代码直接引用C实现的函数时，会默认查找修饰后的符号，与C文件生成的未修饰符号无法匹配。

解决方案 #

步骤1：修正Debug构建参数 #

在Debug任务的args数组中，${workspaceFolder}\\src\\*.cpp参数后新增C文件编译规则，修改后的对应片段如下：

"args": [
    "-g",
    "${workspaceFolder}\\src\\*.cpp",
    "${workspaceFolder}\\src\\*.c",
    "-o",
    // 其余原有参数保持不变
]

你也可以和Release配置一样单独列出每个C文件，用通配符*.c的优势是后续新增C文件无需修改配置。

步骤2：适配C/C++混合编译符号规则 #

二选一即可，推荐第一种方案：

方案A：修改C代码对应的头文件（推荐）

在所有C源文件对应的头文件首尾添加条件编译包裹，告知C++编译器这些函数是C语言实现的，无需做名字修饰：

#ifdef __cplusplus
extern "C" {
#endif

// 此处保留头文件原有全部内容，包括所有函数声明、结构体定义等

#ifdef __cplusplus
}
#endif

方案B：修改C++代码的头文件引入逻辑

在C++代码（如cMain.cpp）中引入C头文件时，用extern "C"包裹引入语句：

extern "C" {
#include "BusCalcs.h"
#include "CG_Engine.h"
#include "Helper.h"
}

完成以上两步后重新执行构建即可解决报错。

额外优化建议 #

如果需要进一步降低程序运行的依赖，可以在编译参数中添加-static选项，该选项会将MinGW运行时库静态链接到程序中，运行时无需额外携带libgcc_s_dw2-1.dll、libstdc++-6.dll等MinGW运行库文件，仅需随程序附带wxWidgets对应的动态库即可。

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