用 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,但要先确定子命令,再处理它的选项。 - 命令名、用法字符串和处理函数最好只维护一处,后续改动不容易漏。
备注:内容仅供参考。
