Bash脚本中变量漏写$符号如何排查？ShellCheck未检测到该问题

我的问题 #

我写了这样一段Bash脚本：

#!/bin/bash
moduleName=$1
someInfo=`ls | grep -w moduleName`
echo $someInfo

结果发现第3行犯了个低级错误——本该用$moduleName引用变量，却漏写了$，导致grep一直在找字符串moduleName，根本没用到传入的参数。我用ShellCheck扫了一遍，它居然没报这个问题，想问问有没有办法能揪出这类错误？

可行的排查方法 #

1. 让ShellCheck更“严格”一点 #

默认ShellCheck不会主动揪出“看起来像变量但没加$的字符串”，但你可以启用所有规则试试，说不定能触发相关警告：

shellcheck --enable=all your_script.sh

有些边缘检测规则默认是关闭的，全开之后可能会帮你发现这类疑似变量引用的问题。

2. 给脚本加上严格模式开关 #

在脚本开头加上这行，能让Bash对变量相关的错误更敏感：

set -euo pipefail

• -e：命令跑失败就立刻退出脚本，不会继续执行后续代码
• -u：用到未定义的变量直接报错，避免静默失败
• -o pipefail：管道里只要有一个命令出错，整个管道都算失败

不过要注意，这个方法没法直接检测到你这种“把变量名当字符串用”的情况（毕竟moduleName作为字符串是合法的），但能帮你提前拦截其他变量相关的坑。

3. 用调试模式看命令执行细节 #

运行脚本的时候加上-x参数，Bash会把每一条执行的命令和展开后的内容都打印出来：

bash -x your_script.sh test_module

比如你传入test_module当参数，正常应该看到grep -w test_module，但实际会打印grep -w moduleName，一眼就能发现变量没被展开的问题，非常直观。

4. 手动用字符串匹配快速定位 #

可以用grep脚本里所有符合变量命名规则（字母下划线开头，后面跟字母数字下划线）但没加$的内容，排除注释和字符串常量：

grep -n '[a-zA-Z_][a-zA-Z0-9_]*' your_script.sh | grep -v '\$' | grep -v '#'

这个命令能帮你快速列出所有可能漏写$的候选，剩下的就是手动筛选哪些是真正该引用变量的地方。

5. 试试其他静态分析工具 #

比如checkbashisms，它本来是检查脚本是否用了非POSIX的Bash特性，但偶尔也能发现这类变量引用的小错误；或者找找ShellCheck的社区扩展规则，说不定有专门针对这类问题的检测。

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