C / C++ / 系统课时
把多个源文件加入目标
把多个源文件加入目标
一个 C 程序变成多文件后,关键不只是“让编译器看到更多 .c 文件”,而是把这些源文件明确归属到某个 CMake 目标。以目标为中心组织源码,依赖、编译选项和链接关系才能跟着目标演进,而不是散落在难维护的全局变量里。
学习目标
- 使用
add_executable为一个目标声明多个源文件 - 理解头文件与源文件在编译和依赖关系中的角色
- 避免用全局源码变量承载大型项目的文件组织
先让一个目标包含多个源文件
下面做一个最小的加法程序,项目包含入口文件和独立的计算模块。
calculator.h:
#ifndef CALCULATOR_H
#define CALCULATOR_H
int add(int left, int right);
#endifcalculator.c:
#include "calculator.h"
int add(int left, int right) {
return left + right;
}main.c:
#include <stdio.h>
#include "calculator.h"
int main(void) {
int result = add(2, 3);
printf("%d\n", result);
return 0;
}CMakeLists.txt:
cmake_minimum_required(VERSION 3.20)
project(multi_source_demo C)
add_executable(app
main.c
calculator.c
)这里真正参与编译的是两个 .c 文件。calculator.h 通过 #include 被使用,不必为了“让编译器找到它”而强制写进 add_executable;把头文件列入目标更多是为了 IDE 展示和工程组织,不改变它由预处理器包含的本质。
构建并验证目标
以 Linux 或 macOS 上常见的单配置生成器为例,在项目根目录执行:
cmake -S . -B build >/dev/null
cmake --build build >/dev/null
./build/app预期输出:
5如果使用多配置生成器,可执行文件可能位于 build/Debug、build/Release 等子目录。配置阶段成功只说明 CMake 已生成构建系统;真正发现缺少函数实现、重复定义等问题,通常要等到编译或链接阶段。
为什么不要依赖全局源码变量
小项目常见这种写法:
set(SOURCES
main.c
calculator.c
)
add_executable(app ${SOURCES})这在两三个文件时可以工作,但当项目出现多个库、测试程序和平台专用文件后,一个全局 SOURCES 很容易变成“所有文件的临时仓库”。变量作用域与目标边界并不一致,后续修改者也难以判断某个文件到底属于哪个目标。
更稳妥的做法是让文件紧跟目标声明。目标较小时,直接写进 add_executable 最清楚;目标较大或需要在不同目录逐步补充源码时,可以使用 target_sources。
完整写法如下:
cmake_minimum_required(VERSION 3.20)
project(multi_source_demo C)
add_executable(app main.c)
target_sources(app PRIVATE
calculator.c
)这份配置与前面的构建结果一致。PRIVATE 表示 calculator.c 只加入 app 自身的源文件集合,不会成为目标的接口源文件;对普通 .c 实现文件来说,这正是最常见的语义。
验证方法仍然是重新配置并构建:
cmake -S . -B build >/dev/null
cmake --build build >/dev/null
./build/app预期输出:
5文件增多时保持目标边界
当项目继续扩大,应优先思考“这个文件属于哪个可执行程序或库”,而不是先维护一个全局文件清单。可执行程序自己的入口和实现归到 add_executable 或 target_sources;可复用模块通常应升级为独立库目标,再通过 target_link_libraries 建立依赖。
这种组织方式让 CMake 配置与工程结构保持一致:源文件跟着目标走,目标再承担编译选项、头文件搜索路径和链接依赖。文件数量增加时,你仍能从目标定义直接看出每一组源码最终会生成什么。