解决 ‘claude code bash: line 1: syntax error near unexpected token `<' 错误的完整指南

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

背景分析：理解 bash 解析器的工作机制

当 bash 遇到 < 符号时，会立即进入重定向解析模式。这个错误通常发生在解析器期望接收命令但遇到重定向符号时。根本原因是：

1. 重定向符号必须紧跟在可执行命令之后
2. 符号前后需要有适当的空格分隔
3. 文件描述符编号（如2>）必须合法

常见触发场景

文件编码问题

• Windows 换行符 (CRLF) 会导致解析异常
• UTF-8 BOM 头可能干扰解释器

语法错误

# 错误示例
< input.txt  # 缺少前置命令

# 正确写法
command < input.txt

执行环境问题

• 未正确指定解释器（缺少 shebang）
• 通过错误方式调用脚本（如 sh script.sh 而非bash script.sh）

系统化解决方案

1. 规范重定向语法

# 标准输入重定向
wc -l < file.txt

# 多重重定向
command 2> error.log < input.txt

2. 文件编码处理

使用 dos2unix 工具转换：

dos2unix script.sh
# 或
sed -i 's/\r$//' script.sh

3. 环境验证

# 检查执行环境
echo "Current shell: $SHELL"

# 确保使用 bash 执行
bash script.sh

实战代码示例

示例 1：简单重定向修复

# 错误
< data.csv grep "pattern"

# 正确
grep "pattern" < data.csv

示例 2：heredoc 使用

# 正确用法
cat <<EOF
Multi-line
content
EOF

避坑指南

1. 始终在 shebang 中明确解释器：#!/bin/bash
2. 使用 shellcheck 进行静态分析
3. 开发时设置set -o nounset -o errexit
4. 重定向符号两侧保留空格
5. 避免在管道中使用复杂重定向

进阶工具配置

安装 shellcheck：

# Ubuntu
sudo apt install shellcheck

# 使用示例
shellcheck -s bash script.sh

性能优化建议

• 对于大量重定向操作，考虑使用文件描述符复用
• 使用 exec 建立持久重定向连接

思考延伸

1. 如何设计一个安全的模板系统来动态生成 bash 脚本？
2. 在哪些场景下应该避免使用 shell 重定向而改用其他方案？
3. 如何正确处理包含特殊字符的文件路径重定向？

通过系统化理解 bash 的解析机制，配合工具链的使用，可以显著降低此类语法错误的发生率。记住：良好的编码规范比事后调试更重要。