gcc 编译多个源文件，最直接有效的写法，就是把所有 .c 文件一次性列在命令行里，并用 -o 指定输出名。

比如有 main.c、utils.c、io.c 三个文件，想生成可执行文件 app：

gcc main.c utils.c io.c -o app

这条命令会自动完成预处理、编译、汇编和链接，效率很高。

不要直接使用 gcc *.c -o app。这样可能误把非项目文件也包含进来，而且不同 shell 的扩展行为也不一样，链接顺序也无法控制。

推荐写法

gcc 编译多个源文件时，建议明确写出参与编译的文件名。

gcc main.c utils.c io.c -o app

这样更直观，也更容易排查问题。

为什么不能只写 gcc *.c -o app？

看起来省事，但实际很容易出问题：

• 如果当前目录下有 test.c、old.c 这类非项目文件，会被误编译进去。
• 某些 shell（如 zsh）对通配符扩展行为不同，可能报错或顺序错乱。
• 链接顺序敏感时，比如静态库依赖，* 展开顺序不可控，可能导致 undefined reference。

如何分步编译

如果想分步编译，可以使用 -c 参数，只生成对应的 .o 文件，不进行链接。

-c 分步编译时目标文件名怎么定？

GCC 默认会按输入文件名生成对应目标文件：

• gcc -c main.c → 输出 main.o
• gcc -c utils.c → 输出 utils.o
• gcc -c main.c utils.c → 同时生成 main.o 和 utils.o

注意：gcc -c main.c -o foo.o 也可以指定输出名，但通常没必要。除非你需要重命名，或者避免覆盖。

出现 undefined reference to 'xxx' 怎么查？

这类报错通常说明函数声明了，但没有被正确定义或链接进来。

• 漏编某个 .c 文件，比如写了 gcc main.c -o app，却忘了加 utils.c。
• 函数在 .h 里声明了，但实现写在 .c 里，而那个 .c 没参与编译。
• 用了 static 修饰函数，导致该函数作用域仅限本文件，其他文件调用时就会链接失败。

可以先快速验证：

• 运行 gcc -c *.c，看是否都生成了对应的 .o。
• 再用 nm *.o | grep xxx，检查符号是否存在。

真正容易卡住的地方

真正麻烦的，往往不是命令怎么写。

而是哪些文件该参与编译、哪些函数实际被谁实现，以及 static 和头文件包含路径怎么协同。

这些问题通常不会报语法错误，但一到链接阶段就很容易卡住。

《夸克》非常好用的免费AI浏览器

下载APP查看