C语言编程中如何实现自定义头文件函数按需编译引入
你当前遇到的体积差异，本质是代码写法和默认编译规则共同导致的：
你把string_lenght的函数实现直接写在了头文件里，C语言的#include是纯文本替换逻辑，只要引入了这个头文件，预处理器就会把头文件全部内容直接插入到当前源文件的对应位置，相当于你直接在test.c里定义了这个函数。默认编译配置下，只要函数存在于当前编译单元，哪怕全程没有调用，也会被生成目标代码，最终链接进可执行文件，这就是引入头文件后程序体积多了40字节的直接原因。
要达到“函数只有被实际调用才会被包含进可执行文件”的效果，需要从代码结构、编译链接参数两个层面调整：
1. 调整代码结构，分离头文件声明和源文件实现
头文件的标准用法是只放对外暴露的声明，不要放函数的具体实现：
- 修改
headertest.h，仅保留依赖引入和函数声明，删除函数实现逻辑：
#include <stddef.h> extern size_t string_lenght(const char *);
- 新建同名源文件
headertest.c，把原头文件里的函数实现迁移到这个文件中：
#include "headertest.h" size_t string_lenght(const char *str) { size_t n = 0; while (str[n] != '\0') n++; return (n); }
这种结构下，函数实现不会在你#include头文件的时候被直接插入到业务代码里，从源头避免了无关代码被塞进主程序编译单元的问题。
不要把非内联函数的实现直接写在头文件里是C语言开发的通用规范，否则不仅会出现无用代码被编入的问题，多源文件引入同一个头文件时还会触发重复定义的编译错误。
2. 配置编译链接参数，开启函数级按需回收
拆分代码后如果直接用默认参数编译链接，没被调用的函数还是可能被保留在最终程序里，需要加两个参数让链接器自动裁剪无用代码：
- 编译每个源文件时加
-ffunction-sections参数：这个参数会让编译器把每个函数单独存到独立的段中，给链接器提供细粒度的裁剪判断基础。 - 链接阶段加
-Wl,--gc-sections参数：这个参数会通知链接器，自动清理所有没有被实际引用的段，也就是没被任何代码调用的函数，不会把它们塞进最终的可执行文件。
对应到你的测试场景，编译命令可以按如下方式写：
# 分别编译两个源文件，开启函数独立段 gcc -ffunction-sections -c test.c -o test.o gcc -ffunction-sections -c headertest.c -o headertest.o # 链接时开启无用段回收 gcc -Wl,--gc-sections test.o headertest.o -o test
按这个配置编译后，只要你在main函数里没有调用string_lenght，这个函数就不会出现在最终的可执行文件里，程序体积和你注释掉头文件引入时的大小完全一致；只有实际写了调用逻辑，对应函数才会被链接进程序。
如果你确实有特殊需求要把短函数直接写在头文件里（比如内联函数场景），可以给函数加static修饰，同时开启-O2及以上的优化等级，编译器检测到函数未被调用时会直接将其优化丢弃，不会生成对应代码。但这种写法不推荐常规使用，每个引入该头文件的源文件都会生成一份函数的独立副本，会增加不必要的编译开销，不如声明实现分离的结构稳妥。
内容的提问来源于stack exchange，提问作者user19139723
