Bash脚本与getopts的case项及函数解析问题排查

先处理-h分支与usage()函数的常见问题 #

这部分错误常引发连锁报错，优先排查：

• 语法结构错误：
  • 检查case语句中-h)的格式：必须是-h)后接换行或空格，分支末尾必须加;;闭合，示例：

    case "$1" in
        -h)
            usage
            exit 0  # 必须退出，否则脚本会继续执行后续逻辑
            ;;
        # 其他分支
    esac
    

  • 检查usage()函数定义：函数体必须用{}包裹，内部语句要符合语法，示例：

    usage() {
        echo "Usage: $0 -t <启动模板名称> -v <源版本号> [-h]"
        echo "说明：创建指定AWS启动模板的新版本"
        exit 0
    }
    

    常见错误是漏写{}、函数内echo的特殊字符未转义（比如包含>或|时没加引号）。
• 退出逻辑缺失：
  -h分支调用usage后必须添加exit 0，否则脚本会继续执行后续代码，导致ShellCheck误报更多无关错误。

区分连锁错误与独立错误的排查方法 #

1. 优先修复语法类错误：
   ShellCheck报的SC1009（未闭合的引号）、SC1073（case分支语法错误）这类语法问题，会导致后续代码被误判为错误。先修复这些，再重新运行ShellCheck，很多警告会自动消失。
2. 逐类验证变量与参数：
   • 所有变量引用必须加双引号，比如"$template_name"而非$template_name，避免空格或特殊字符引发的参数拆分问题（对应ShellCheck的SC2086警告）。
   • 检查AWS CLI命令的参数格式：比如--launch-template-data的JSON内容是否正确闭合，变量替换是否生效，示例：

     aws ec2 create-launch-template-version \
         --launch-template-name "$template_name" \
         --source-version "$source_version" \
         --launch-template-data '{"InstanceType": "t3.micro"}'
     

     常见错误是JSON引号混用（单双引号冲突）、变量未提前初始化就使用（SC2154警告）。
3. 分步测试脚本：
   注释掉AWS CLI调用部分，先测试参数解析逻辑（比如传入-h看是否正常输出帮助并退出，传入合法参数看变量是否正确赋值），确认参数逻辑没问题后再恢复AWS命令测试。

常见独立错误示例 #

• 未检查AWS CLI命令的返回值：脚本不会判断命令是否执行成功，可添加set -e让脚本在命令失败时退出，或手动判断$?的值。
• 硬编码敏感信息：比如把AWS密钥写在脚本里，ShellCheck会报安全警告，应改用环境变量或AWS凭证文件。

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