如何在多个CPP文件中调用函数并解决unresolve external symbol错误

首先咱们拆解下你的问题：从你给出的代码结构来看，func_i_want_to_include()的声明放在头文件、定义单独写在my_function.cpp里——这其实是C++的标准规范写法，理论上不会产生多副本冲突。你遇到的链接错误，大概率是编译时没把my_function.cpp纳入链接流程，而非函数被重复处理。

不过既然你提到要让链接器识别函数为同一实体、避免生成多副本，我分两种场景给你说明：

场景1：你当前的代码结构（声明在头，定义在cpp） #

要解决当前的链接错误，只需要确保编译时把所有相关的.cpp文件都传给编译器/链接器。比如用GCC编译的话，执行命令：

g++ main.cpp my_function.cpp file_b.cpp -o my_program

如果用Visual Studio，就把这三个cpp文件都添加到项目的源文件列表中。

这种方式下，func_i_want_to_include()的定义只会在my_function.o里生成一份，其他cpp文件里的函数调用都会链接到这个唯一实体，自然不会出现重复定义或未解析符号的问题。

场景2：如果需要把函数定义写在头文件里（避免单独cpp） #

如果因为需求（比如小函数想做内联优化）要把函数体直接放在头文件里，这时候每个包含该头文件的cpp都会生成一份函数副本，链接时就会触发重复定义错误。这时候可以用以下方法让链接器识别它们是同一实体：

方法1：用inline关键字修饰函数 #

在头文件里修改函数声明和定义：

// 加头文件保护，避免重复包含
#pragma once
inline void func_i_want_to_include() {
    puts("hello world");
}

inline关键字会告诉编译器：这个函数允许在多个编译单元存在副本，但链接器要把它们合并成一个唯一实体，同时还能让编译器做内联优化。记得一定要给头文件加保护（#ifndef宏或者#pragma once），避免重复包含导致编译错误。

方法2：别用static（除非你想每个cpp有独立副本） #

static修饰函数会让它的作用域限制在当前编译单元，每个包含头文件的cpp都会生成独立的函数副本，这完全不符合你要“同一实体”的需求，所以绝对不推荐。

总结 #

• 你当前的代码结构是正确的，链接错误的核心原因是遗漏了my_function.cpp的编译链接；
• 如果要把函数定义放头文件，用inline关键字确保链接器合并多副本为同一实体；
• 始终给头文件加保护，避免重复包含的编译错误。

内容的提问来源于stack exchange，提问作者j.r.