C / C++ / 系统课时

把核心逻辑拆成独立库

把核心逻辑拆成独立库

这一节把命令行工具拆成“核心库 + 可执行入口”两个目标。核心库只处理文本统计,入口只负责参数校验和调用,这样同一份业务逻辑既能被命令行程序复用,也能在后续测试中被直接链接和验证。

学习目标

  • 能区分命令行入口与核心业务逻辑的职责边界
  • 能用 add_library、add_executable 和 target_link_libraries 建立目标关系
  • 能构建并运行程序,确认可执行目标确实通过核心库完成工作

先划清库与入口边界

拆库的关键不是把文件移动到不同目录,而是让依赖方向变清楚:textstat 可执行程序依赖 textstat_core,核心库本身不依赖命令行参数、终端输出或进程退出码。这样测试代码可以绕过 main,直接调用稳定的 C 接口。

命令行入口与核心库的依赖关系

这里的核心 API 还显式返回错误码。这样错误参数属于库的契约,而“参数数量不对时打印 usage”仍然属于命令行入口的职责。

用 CMake 建立两个目标

下面是一个可独立复现的最小工程。片段示例:以下四个文件共同组成完整程序,单个文件不能独立运行。

include/textstat.h:

c
#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);

#endif

src/textstat.c:

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:

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
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 执行:

bash
cmake -S . -B build >/dev/null
cmake --build build >/dev/null
./build/textstat "hello cmake world"

预期输出:

text
words=3

如果使用多配置生成器或 Windows,最终可执行文件路径可能不同,应以构建目录中的实际产物位置为准。只要 textstat_core 能先被构建,随后 textstat 成功链接并输出统计结果,就说明两个目标的依赖已经生效。

拆库后的判断标准

判断是否真的“拆成了库”,可以看三个信号:核心源文件不包含 main;核心接口不接触 argc、argv、终端打印等入口细节;可执行目标只保留参数解析、错误呈现和业务调用。做到这三点,后续测试就能直接链接 textstat_core,而不用启动完整命令行程序。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把核心逻辑拆成独立库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通