共计 1146 个字符，预计需要花费 3 分钟才能阅读完成。

Bash 脚本报错解析

错误背景

这个报错通常出现在以下场景中：

• 在脚本中直接使用未转义的 < 符号
• here-document 语法使用不规范
• 变量赋值时意外包含重定向符号
• 字符串比较时误用重定向符号
• 管道和重定向符号混用

语法原理

Bash 解析器在读取脚本时，会分多个阶段处理特殊符号：

1. 词法分析阶段：识别特殊字符（如 <, >, |）
2. 解析阶段：构建命令结构
3. 执行阶段：处理重定向和管道

当解析器在预期命令参数的位置遇到重定向符号时，就会抛出这个错误。

解决方案

场景 1：直接使用未转义的重定向符号

错误代码：

echo < input.txt

修正代码：

cat < input.txt

场景 2：here-document 语法错误

错误代码：

cat << EOF
Hello World
EOF<

修正代码：

cat << EOF
Hello World
EOF

场景 3：变量赋值包含重定向符号

错误代码：

var=<value

修正代码：

var="<value"

场景 4：字符串比较误用重定向

错误代码：

if [$var < "value"]; then

修正代码：

if [[$var < "value"]]; then

场景 5：管道和重定向混用

错误代码：

echo "test" | cat < input.txt

修正代码：

echo "test" | cat input.txt

调试技巧

ShellCheck 是检测 Bash 脚本问题的利器，安装方法：

# Ubuntu/Debian
sudo apt install shellcheck

# CentOS/RHEL
sudo yum install shellcheck

# macOS
brew install shellcheck

使用示例：

shellcheck myscript.sh

常见检测规则：

• SC1071: 检查 here-document 语法
• SC1036: 检测无效的重定向
• SC1068: 检查错误的赋值语法

最佳实践

1. 始终对特殊字符进行转义或引用
2. 使用 [[]] 代替 [] 进行字符串比较
3. 避免在变量赋值中使用特殊符号
4. 使用 set -o nounset 检测未定义变量
5. 使用 set -o pipefail 捕获管道错误
6. 复杂的重定向操作拆分成多行
7. 在脚本开头声明 #!/bin/bash 解释器
8. 定期使用 ShellCheck 检查脚本
9. 测试脚本时使用 bash -n 进行语法检查
10. 记录所有重定向操作的输入输出

经验总结

处理 Bash 脚本错误时，理解解析器的处理顺序非常重要。大多数情况下，错误都是由于特殊字符处理不当造成的。通过正确引用和转义，结合静态检查工具，可以显著提高脚本质量。

记住：Bash 不是 Python，它的语法规则更加严格，特别是在处理特殊符号时。养成良好的编码习惯，比如始终引用变量、显式声明重定向目标，可以避免 90% 的语法错误。

最后，建议在编写复杂脚本时，先在小规模测试环境中验证语法，再逐步增加功能。这样可以快速定位问题，提高开发效率。