macOS下Bash脚本getopts解析-h参数无法显示帮助问题

核心成因 #

问题出在getopts的选项字符串（optstring）编写错误，和macOS系统本身没有直接关系。

你脚本中getopts使用的选项字符串是:h:p:f:i:，而getopts对选项字符串的解析规则是：

• 字符串开头的:代表开启静默错误模式，遇到参数错误时不自动打印系统报错，交由脚本自行处理
• 单个普通字符代表无参数选项，比如单独的h就代表-h不需要携带传值
• 字符后面紧跟一个:，代表该选项必须携带参数值，比如p:就代表-p后面必须传入端口参数

按照这个规则拆解你写的:h:p:f:i:，实际定义的选项规则是：

• -h：必须携带参数（h后面紧跟了冒号）
• -p：必须携带参数
• -f：必须携带参数
• -i：必须携带参数

这和你预期的「-h是不需要传值的帮助选项」完全不符——你手滑在h后面多打了一个冒号，把-h标记成了必须传参的选项。
当你执行script.sh -h时，因为-h后面没有跟随参数，属于「必填参数缺失」的错误：在你开启的静默错误模式下，getopts会将循环变量option赋值为:，但你的case分支里没有编写匹配:的处理逻辑，这个错误分支会被直接跳过，整个while getopts循环正常结束后，脚本会继续往下执行ssh-copy-id相关的业务逻辑，最终表现和无参数执行脚本完全一致，帮助信息不会触发。

这也完全符合你观察到的现象：-p/-f/-i这类本身需要参数的选项逻辑正常，非法参数会触发你写的\?)分支报错，只有无参数的-h选项失效。

修复方案 #

把getopts那行的选项字符串里h后面多余的冒号删掉即可，修改后代码为：

while getopts ":hp:f:i:" option; do

修改后-h会被正确识别为无参数选项，执行script.sh -h时会正常进入h)分支打印帮助信息后退出。

如果要提升脚本鲁棒性，可以在case里补充缺失参数的处理分支，对应静默模式下缺参返回的:值：

:)
      echo "选项 -$OPTARG 缺少必填参数"
      show_help
      exit 1
      ;;

内容的提问来源于stack exchange，提问作者DeltaIV