为何C编译器无法编译包含inline函数的代码？

问题重现 #

代码示例：

inline void inline_func() {}
static inline void static_inline_func() {}

void some_func()
{
    // 调用inline函数报错
    inline_func();

    // 调用static inline函数正常
    static_inline_func();
}

int main(int argc, char *argv[])
{
    some_func();
    return 0;
}

编译报错（GCC/Clang默认优化级别-O0）：

$ gcc -Wall -o main main.c
/usr/bin/ld: /tmp/ccs7lKMm.o: in function `some_func':
main.c:(.text+0x15): undefined reference to `inline_func'
collect2: error: ld returned 1 exit status

添加-Os优化后编译正常：

$ gcc -Wall -Os -o main main.c

核心原因 #

1. C标准对inline函数的定义

C99及后续标准中，inline仅作为编译器内联建议，不是强制要求：

• 无static修饰的inline函数属于外部链接，如果编译器未选择内联（比如默认-O0优化时，编译器更倾向于保留函数调用以方便调试），会生成对该函数外部实体的调用。
• 但你的代码中仅提供了inline版本的定义，没有配套的外部定义（即不带inline关键字的函数实体），链接器找不到对应符号，因此报错。

2. static inline无问题的原因

static inline赋予函数内部链接属性：

• 该函数仅在当前编译单元可见，编译器会为每个包含它的编译单元生成独立的函数副本（或直接内联），无需依赖外部定义，因此链接时不会出现符号缺失。

3. -Os优化解决问题的原因

-Os是针对代码大小的优化选项，编译器会优先选择内联inline函数：

• 此时inline_func()会被直接展开到调用点，不会生成外部函数调用，自然不需要查找外部定义，链接过程无报错。

解决方法 #

推荐两种方案：

• 方案一：改用static inline
  给inline函数添加static修饰，让它成为内部链接，彻底避免外部依赖：

  static inline void inline_func() {}
  

• 方案二：提供外部定义
  在代码中补充该函数的外部实体定义（可放在当前文件或其他编译单元）：

  inline void inline_func() {}
  // 补充外部定义
  void inline_func() {}
  

  注意：这种方式如果多个编译单元都包含该定义，可能触发重复定义错误，因此更推荐方案一。

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