C 语言命令行参数解析

更新时间：2026-08-26。本文是 languages/c/ 主题高手层文档。

本文要回答的问题

• argc/argv 到底是什么？argv[0] 里装的是谁？
• 怎么支持 -h、--help、-o file 这类选项？
• 手写解析和 getopt 各在什么时候用？

一、argc 与 argv

int main(int argc, char *argv[]) {
    /* argc: 参数个数（含程序名） */
    /* argv[0]: 程序名，argv[1..] 才是用户参数 */
}

• ./prog a b → argc == 3，argv[1]=="a"、argv[2]=="b"。
• argv[argc] 恒为 NULL——可以放心以 NULL 结尾遍历。

二、手动解析 vs getopt

方式	适合	特点
手写遍历	参数少、无选项	简单直白，规则随意
getopt	标准短选项 -x	POSIX 标准，处理 -abc 合并
getopt_long	长短选项 --name	GNU 扩展，支持 --name=value

while ((c = getopt(argc, argv, "ho:")) != -1) {
    switch (c) {
    case 'h': help(); break;
    case 'o': outfile = optarg; break;
    }
}

三、工程要点

• 约定俗成：-h/--help、-v/--version、-o <file>；未知选项报错并退出非 0。
• 参数校验：缺参数、非法值要给清晰错误信息，见 错误处理。
• 选项与位置参数混排的处理：-- 之后全部当作位置参数。
• 程序返回码：正常 0，用法错误 1/2 等，见 return 与退出码。

实测：argc/argv 与 getopt

运行 ./ect -h -o out.txt arg1 arg2：

#include <getopt.h>
while ((c = getopt(argc, argv, "ho:")) != -1) {
    switch (c) {
    case 'h': /* help */ break;
    case 'o': outfile = optarg; break;   // optarg 是选项参数
    }
}

实测输出：

argc=6, argv[0]=./ect        ← argc 含程序名，argv[0] 是程序名
argv[1]=-h  argv[2]=-o  argv[3]=out.txt  argv[4]=arg1  argv[5]=arg2
帮助: -h 帮助, -o <file> 输出文件
输出文件: out.txt             ← getopt 解析 -o 拿到 optarg

要点：argc 包含程序名（所以是 6 不是 5），argv[0] 是程序路径；getopt 的 "ho:" 里 o: 表示 -o 需要跟一个参数，optarg 存的就是那个参数。

四、与入门层的衔接

• main 函数与返回值，见 main 与返回值。
• 字符串比较遍历参数，见 字符串函数。

一句话总结

argc/argv 是"程序名+参数们"的约定，选项解析用 getopt 省心且标准：短选项 getopt、长选项 getopt_long、参数校验别偷懒。

---

本文已完成填充：示例代码与实测数据已补齐。