C / C++ / 系统课时
把核心逻辑拆成独立库
把核心逻辑拆成独立库
这一节把命令行工具拆成“核心库 + 可执行入口”两个目标。核心库只处理文本统计,入口只负责参数校验和调用,这样同一份业务逻辑既能被命令行程序复用,也能在后续测试中被直接链接和验证。
学习目标
- 能区分命令行入口与核心业务逻辑的职责边界
- 能用
add_library、add_executable和target_link_libraries建立目标关系 - 能构建并运行程序,确认可执行目标确实通过核心库完成工作
先划清库与入口边界
拆库的关键不是把文件移动到不同目录,而是让依赖方向变清楚:textstat 可执行程序依赖 textstat_core,核心库本身不依赖命令行参数、终端输出或进程退出码。这样测试代码可以绕过 main,直接调用稳定的 C 接口。

这里的核心 API 还显式返回错误码。这样错误参数属于库的契约,而“参数数量不对时打印 usage”仍然属于命令行入口的职责。
用 CMake 建立两个目标
下面是一个可独立复现的最小工程。片段示例:以下四个文件共同组成完整程序,单个文件不能独立运行。
include/textstat.h:
#ifndef TEXTSTAT_H
#define TEXTSTAT_H
#include <stddef.h>
enum {
TEXTSTAT_OK = 0,
TEXTSTAT_ERR_INVALID = 1
};
/* 核心库只接收业务数据,不感知 argc、argv 或终端。 */
int textstat_count_words(const char *text, size_t *out_count);
#endifsrc/textstat.c:
#include "textstat.h"
#include <ctype.h>
int textstat_count_words(const char *text, size_t *out_count)
{
if (text == NULL || out_count == NULL) {
return TEXTSTAT_ERR_INVALID;
}
size_t count = 0;
int in_word = 0;
for (const unsigned char *p = (const unsigned char *)text; *p != '\0'; ++p) {
if (isspace(*p)) {
in_word = 0;
} else if (!in_word) {
++count;
in_word = 1;
}
}
*out_count = count;
return TEXTSTAT_OK;
}app/main.c:
#include "textstat.h"
#include <stdio.h>
int main(int argc, char **argv)
{
if (argc != 2) {
fprintf(stderr, "usage: textstat <text>\n");
return 2;
}
size_t count = 0;
if (textstat_count_words(argv[1], &count) != TEXTSTAT_OK) {
fprintf(stderr, "textstat: invalid input\n");
return 1;
}
printf("words=%zu\n", count);
return 0;
}根目录 CMakeLists.txt:
cmake_minimum_required(VERSION 3.20)
project(textstat LANGUAGES C)
add_library(textstat_core STATIC
src/textstat.c
)
target_include_directories(textstat_core
PUBLIC
${CMAKE_CURRENT_SOURCE_DIR}/include
)
target_compile_features(textstat_core PUBLIC c_std_11)
add_executable(textstat
app/main.c
)
target_link_libraries(textstat
PRIVATE
textstat_core
)PUBLIC 的包含目录会传递给链接该库的目标,因此 app/main.c 能直接包含 textstat.h;PRIVATE 链接则表示 textstat 使用核心库,但不会把这种依赖继续向外传播。
构建并验证调用关系
在包含上述目录和文件的工程根目录、使用 Bash 或兼容 Shell 执行:
cmake -S . -B build >/dev/null
cmake --build build >/dev/null
./build/textstat "hello cmake world"预期输出:
words=3如果使用多配置生成器或 Windows,最终可执行文件路径可能不同,应以构建目录中的实际产物位置为准。只要 textstat_core 能先被构建,随后 textstat 成功链接并输出统计结果,就说明两个目标的依赖已经生效。
拆库后的判断标准
判断是否真的“拆成了库”,可以看三个信号:核心源文件不包含 main;核心接口不接触 argc、argv、终端打印等入口细节;可执行目标只保留参数解析、错误呈现和业务调用。做到这三点,后续测试就能直接链接 textstat_core,而不用启动完整命令行程序。