未被调用的Func为何引发SomeOtherFunc链接器未解析外部符号错误？

问题复现代码 #

#include <iostream>

using namespace std;

void SomeOtherFunc ();

void Func ()
{
    SomeOtherFunc ();
}

int main ()
{
    cout << "Hello";

    return 0;
}

问题说明 #

上述代码中Func函数从未被调用，但它内部引用了未定义的SomeOtherFunc，编译时会触发链接器错误：Unresolved external symbol，提示找不到SomeOtherFunc的定义，且该问题在MSVC和g++中均会出现。

原因解释 #

默认编译模式下，编译器会保留所有非静态全局函数的编译结果，哪怕它们没被当前代码调用。链接器无法预判这个函数是否会被其他编译单元（比如其他.cpp文件）调用——比如如果这个文件是某个静态库的一部分，其他代码可能后续会调用Func。因此链接器必须确保Func里所有的符号引用都能被解析，否则一旦其他模块调用Func，程序就会崩溃。

解决方法 #

• 将函数改为静态作用域：把Func声明为static void Func()，这样它就变成文件内部可见的函数，编译器会标记为内部链接。此时链接器知道其他模块无法访问它，如果函数未被调用，编译器会直接优化掉，也就不会处理里面的SomeOtherFunc引用。
• 启用死代码消除优化：开启编译器的优化选项，比如g++使用-O/-O2，MSVC使用/O1//O2。优化器会自动识别并移除未被调用的全局函数，从而避免链接器处理无效的符号引用。
• 直接移除无用函数：如果Func本来就是冗余代码，直接删除即可彻底解决问题。

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