[开发工具]【c++ debug】recipe for target xxx failed xxx.so: 对‘self-defined function‘ 未定义的引用

1. 问题

在源文件中该包含的地方都包含了头文件，编译时还是报"未定义引用"
?
xxx.so: 对’self-define function(自定义函数)’ 未定义引用

build.make:23: recipe for target ‘xxx(可执行文件)’ failed

?
问题描述：

• 在生成可执行文件的时候，要链接的库文件对自定义函数的未定义引用

• 编译进度甚至到了100%，但最后生成可执行文件报错

2. 原因

• C/C++编译目标文件时并不需要函数的具体实现，正确声明即可，比如包含了头文件

• 但是生成可执行文件的时候，需要找到被调函数的具体实现。函数名就好比指针常量，需要找到指针所指的具体内容（个人理解）

3. 解决方法

• 如果是cmake编译，需要在CMakeLists.txt中包含新增的源文件

cmake_minimum_required(VERSION 3.0)
project(main)

set(SRC_LISTS
	path/to/your/file.cpp		// ! add new source file
	xxx/other.cpp
)

add_library(projectLib ${SRC_LISTS})
add_executable(${PROJECT_NAME} ${SRC_LISTS})

• 如果是普通gcc/g++编译，需要将新增源文件关联起来

g++ main.cpp new.cpp -o main	// 注意依赖顺序，被依赖的放在后面

• 如果是vscode task.json设置编译规则，需添加新增源文件

"args": [
	"-g",
	"${file}",
	"${fileDirname}\\path\\to\\your\\file.cpp",	// ! add new source file
	"-o",
	"${fileDirname}\\${fileBasenameNoExtension}.exe"
],

?

参考文章：
关联新增源文件
task.json设置编译规则
常见undefined reference解决方法
?
created by shuaixio, 2021.12.12