排查 shell case 语句语法错误，优先用 bash -n 做语法预检，配合 shellcheck 工具定位具体问题，再逐段注释缩小范围。
先说结论：case 语句语法错误通常由缺少;;分隔符、esac 结束关键字或引号括号不匹配引起，用静态检查工具比肉眼排查更高效。
- 先确认：用 bash -n script.sh 检查语法，不执行脚本就能发现结构问题
- 先处理：运行 shellcheck script.sh 获取具体错误位置和修复建议
- 再验证：修复后重新执行语法检查，确认无报错后再运行脚本
命令速用版
以下是排查 case 语句语法错误的常用命令，可直接在终端执行：
bash -n your_script.sh shellcheck your_script.sh
第一条命令只做语法检查不执行脚本，第二条会给出详细的错误说明和修复建议。如果 shellcheck 未安装，可通过包管理器安装（如 apt-get install shellcheck 或 brew install shellcheck）。
bash -n 报错示例：
bash -n case_test.sh case_test.sh: line 10: syntax error near unexpected token 'esac' case_test.sh: line 10: `esac'
shellcheck 报错示例：
shellcheck case_test.sh In case_test.sh line 5:start) echo "starting"^-- SC1073: Couldn't parse this case expression.
错误案例与修复对比
通过具体代码对比，可以更直观地理解 case 语句的常见语法错误形态。
错误写法 1：缺少;;分隔符
case $action instart)echo "Starting service"# 缺少 ;; 会导致语法错误或逻辑穿透stop)echo "Stopping service";; esac
修正写法：
case $action instart)echo "Starting service";; # 补充分隔符stop)echo "Stopping service";; esac
错误写法 2：缺少 esac 或括号不匹配
case $action instart)echo "Starting";;# 缺少 esac 结束关键字
此类错误通常导致 bash -n 报 unexpected end of file。
分步处理
第一步：语法预检
先运行 bash -n script.sh，这条命令只检查语法不执行脚本。如果输出 syntax error: unexpected end of file，说明有结构不配对的问题，常见于 if/fi、case/esac、for/done 等关键字缺失。
第二步：工具定位
使用 shellcheck script.sh，它能指出潜在语法、逻辑及风格问题，并给出修复建议。针对 case 语句，它常能识别出未终止的模式分支或解析失败的表达式。每个警告都有编号和解释，方便针对性修复。
第三步：逐段注释
如果工具没定位到具体问题，从末尾开始注释掉部分代码，观察是否还报错，逐步逼近问题区。case 语句尤其要注意每个分支的;;是否完整，esac 是否遗漏。
第四步：检查基础结构
确认 shebang 行是否正确（如#!/bin/bash），避免在 sh 下运行 bash 特有语法。检查成对符号如 []、()、{}、""、'' 是否匹配，落单也会导致错误。
怎么验证是否生效
修复后重新运行 bash -n script.sh，无输出表示语法检查通过。然后执行 shellcheck script.sh，确认没有新的警告。最后实际运行脚本，用 echo $? 检查退出码，非零通常表示失败。
对关键变量，可用 echo "$var" 或 printf '%q\n' "$var" 查看真实值，含空格或换行时尤其需要加引号验证。
常见坑
1. 缺少;;导致逻辑穿透或报错
case 语句中除最后一个分支外，每个分支必须以;;结尾。缺少;;不仅可能导致逻辑上执行下一个分支的代码（fallthrough），在某些 shell 实现中还会直接引发语法错误。
2. 模式匹配中的引号问题
变量在 case 模式中使用时建议加引号，防止 glob 展开意外匹配。例如 case "$var" in 比 case $var in 更安全，尤其是当变量包含空格或特殊字符时。
3. 报错行号滞后
报错通常只提示行号，但真正问题可能在上文。比如缺少;;可能导致后续分支被误解析，实际错误位置需要结合上下文判断。用编辑器语法高亮或 shellcheck 检查能减少这类问题。
参考建议
遇到复杂语法问题，可查阅 GNU Bash 官方手册中关于 Case Constructs 的章节，或使用 man bash 命令本地查阅详细语法定义。
原文链接：https://www.zjcp.cc/ask/11050.html