Bash脚本新手避坑指南：如何解决 `-bash: syntax error near unexpected token `newline` 错误

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

错误背景

当你在 Linux 环境下执行 Bash 脚本时，可能会遇到 -bash: syntax error near unexpected tokennewline“ 这样的错误提示。这种错误通常发生在以下几种情况：

• 换行符差异：在 Windows 系统编写的脚本，换行符是\r\n，而 Linux 系统使用的是\n，这会导致解析错误。
• 引号不匹配：脚本中引号（单引号或双引号）没有正确闭合，导致 Bash 解析器无法正确识别命令边界。
• 隐藏字符：脚本中可能包含不可见的特殊字符，比如制表符或 UTF-8 BOM 头。

诊断方法

1. 查看隐藏字符 ：使用cat -A 命令可以显示脚本中的所有字符，包括不可见的特殊字符。

cat -A your_script.sh

如果看到^M$，说明存在 Windows 换行符；如果看到^I，说明有制表符问题。

1. 语法检查 ：使用bash -n 命令可以检查脚本的语法错误，而无需实际执行脚本。

bash -n your_script.sh

这会输出具体的语法错误位置。

1. 逐行调试 ：通过set -x 开启调试模式，可以逐行执行脚本并查看实际执行的命令。

set -x
./your_script.sh
set +x

解决方案

修复换行符问题

如果脚本的换行符是 \r\n，可以使用dos2unix 工具转换：

dos2unix your_script.sh

或者使用 sed 命令手动替换：

sed -i 's/\r//' your_script.sh

修复引号不匹配问题

以下是一个引号未闭合的错误脚本示例：

#!/bin/bash
echo "Hello, world  # 缺少闭合引号

修正后的脚本：

#!/bin/bash
echo "Hello, world"  # 正确闭合引号

修复隐藏字符问题

如果脚本中包含不可见字符，可以使用 tr 命令删除：

tr -d '\r' < your_script.sh > fixed_script.sh

最佳实践

1. 统一换行符：在开发脚本时，确保使用 Linux 换行符（\n）。可以在 IDE 中配置自动转换。
2. 使用 ShellCheck：安装 shellcheck 工具进行静态分析，提前发现潜在问题。

sudo apt-get install shellcheck  # Debian/Ubuntu
shellcheck your_script.sh

1. IDE 配置：使用支持 Bash 语法高亮和检查的编辑器（如 VS Code、Sublime Text），并启用换行符自动检测。

进阶提示

除了上述方法，还可以使用 xxd 命令查看脚本的十六进制表示，进一步排查隐藏字符问题：

xxd your_script.sh

实战案例

假设我们有一个脚本test.sh，执行时报错：

./test.sh
-bash: syntax error near unexpected token `newline`

诊断步骤

1. 使用 cat -A 查看隐藏字符：

cat -A test.sh

输出显示：

#!/bin/bash^M$
echo "Hello, world^M$

发现 ^M 字符，说明是 Windows 换行符问题。

1. 使用 dos2unix 修复：

dos2unix test.sh

1. 再次执行脚本，问题解决。

结语

-bash: syntax error near unexpected tokennewline` 错误虽然常见，但通过正确的诊断和修复方法，可以快速解决。建议在开发过程中养成良好的习惯，比如使用shellcheck` 工具和统一换行符，以减少这类问题的发生。