PAYATHON 2026

用 C 高效实现带子命令的 CLI 应用

数据小陈

结论

子命令分派不必散落在 main 里的长串 if/else if 中。可以用一张静态命令表保存“命令名 + 处理函数”,main 只从 argv[1] 取命令名,查表后调用对应处理函数。新增命令通常只需增加表项和处理函数,主分派流程不用动。strcmp 仍然要用,但只出现在分派器里。

基本结构

以 ./program init-project "Test" 为例,argv[1] 是命令名,argv[2] 是该命令的参数。下面的例子用函数指针表完成分派:

#include <stdio.h>
#include <string.h>

typedef int (*CommandFn)(int argc, char **argv);

typedef struct {
    const char *name;
    CommandFn handler;
} Command;

static int init_project(int argc, char **argv) {
    if (argc < 3) {
        fprintf(stderr, "用法: %s init-project <name>\n", argv[0]);
        return 1;
    }
    printf("初始化项目: %s\n", argv[2]);
    return 0;
}

static int init_settings(int argc, char **argv) {
    (void)argc;
    (void)argv;
    printf("初始化设置\n");
    return 0;
}

static const Command commands[] = {
    {"init-project", init_project},
    {"init-settings", init_settings},
    {NULL, NULL}
};

int main(int argc, char **argv) {
    if (argc < 2) {
        fprintf(stderr, "用法: %s <command> [args...]\n", argv[0]);
        return 1;
    }

    for (const Command *c = commands; c->name != NULL; c++) {
        if (strcmp(argv[1], c->name) == 0) {
            return c->handler(argc, argv);
        }
    }

    fprintf(stderr, "未知命令: %s\n", argv[1]);
    return 1;
}

进一步扩展

如果有 init project 和 init settings 这类两级子命令,可以让处理函数接收子命令之后的参数,或者在 Command 里增加子命令表。两级分派仍可沿用同一思路,这样 main 里不用写死每一层判断。

命令多时,线性查表通常还能接受;表很大时,可以把命令表按名称排序后用 bsearch,或改用哈希表。开始时不一定要做这层复杂化。

注意事项

  • 每个命令通常仍要有自己的处理函数,这是职责分离;命令表省掉的是重复的 strcmp 和 if 分派代码。
  • 检查 argc,避免访问不存在的 argv[2];错误信息建议写到 stderr,并返回非 0 退出码。
  • 子命令本身属于非选项参数;选项解析可以交给 getopt 或 getopt_long,但要先确定子命令,再处理它的选项。
  • 命令名、用法字符串和处理函数最好只维护一处,后续改动不容易漏。

备注:内容仅供参考。