getopts 仅支持简单短选项，无法原生解析长选项、可选参数、混合短选项或带空格多值参数；复杂需求应选用 getopt、argparse 等专业工具。

getopts 无法原生解析长选项（--help）、可选参数（-v[=val]）、混合短选项（-abc）或带空格的多值参数（-I /usr/include /usr/local/include）。它只适合中小规模脚本中结构清晰的短选项组合。所谓“用 getopts 解析复杂长短参数组合”，本质上是个常见误解——工具能力边界不能靠技巧突破，而应理性选型。

短选项规范写法与关键细节

声明字符串必须严格匹配参数需求：

• a:f:: 表示 -a 必须带值，-f 可选带值（两个冒号）
• 漏掉冒号（如写成 "a:f"）会导致 -f filename 中的 filename 不进 OPTARG，而是被当作下一个未识别选项
• 所有需参数的选项后必须加冒号；不带参数的（如 -h）不加
• 选项字符不能是 : 或 ?

错误处理要区分缺失参数和非法选项

默认模式下，-z 和 -a 后无值都会触发相同错误提示。如需分别处理：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

• 在 opts 字符串开头加冒号：":a:f:"
• 此时：OPTARG="z" 且 opt="?" → 非法选项
• 而：OPTARG="a" 且 opt=":" → 缺失必需参数
• case 分支中必须单独判断 ":" 和 "?"，不能混为一谈

非选项参数（位置参数）要手动提取

getopts 不会自动剥离已处理的选项，需主动跳过：

• 循环结束后执行：shift $((OPTIND - 1))
• 此时 $@ 剩余的就是文件名、路径等非选项参数
• 建议立即存入数组：files=("$@")，避免后续 shift 影响
• 注意：如果命令行是 script.sh -f conf.txt arg1 arg2，则 arg1 arg2 才是真正的非选项参数

长选项和复杂组合请直接换工具

强行用 getopts 模拟长选项（比如检查 $1 == "--help"）会破坏一致性、增加维护成本，且无法支持 --output=file.txt 或 -abc 等 POSIX 兼容写法：

• 标准方案：用外部 getopt（注意带 p），配合 -o（短选项）、--long（长选项）、eval set --
• 更现代方案：对 CLI 工具要求高时，改用 Python 的 argparse 或 Go 编写轻量二进制 —— shell 不是万能胶水
• 若坚持 Shell，且仅需少量长选项补丁，可用简单 case 匹配，但不要指望它能替代 getopt 的完整语义