如何明确声明有意的单词拆分以规避ShellCheck的SC2046警告？

确实，ShellCheck的SC2046警告大多时候帮我们避开了意外的单词拆分坑（比如你提到的cd ${SOME_DIR} || exit 1，要是SOME_DIR带空格，直接展开肯定会切错目录），但当我们故意要做单词拆分时——比如gcc ${OPTIONS}这种场景，OPTIONS里存了一堆编译参数——这个警告就显得有点多余了。下面有几种规范的处理方式：

1. 用ShellCheck注释局部禁用警告 #

这是最直接的方式，在触发警告的代码行末尾加个注释，明明白白告诉ShellCheck你是有意这么写的：

gcc ${OPTIONS} ... # shellcheck disable=SC2046

这种方法的好处是精准，只会关掉当前行的SC2046警告，不会影响其他代码的检查逻辑。

2. 改用数组存储参数（推荐的规范写法） #

如果你的参数列表是自己可控的，强烈建议用数组替代字符串变量，这样既符合Shell的最佳实践，ShellCheck也会自动识别这是合法的参数展开：

# 用数组定义多参数
OPTIONS=(-O2 -Wall -Wextra)
# 用数组展开传递参数
gcc "${OPTIONS[@]}" ...

数组的优势在于，哪怕参数里带空格（比如-D"APP_VERSION=1.0.0"这种），也能完整传递给命令，不会出现意外拆分，比字符串变量拆分安全得多。

3. 用eval明确执行单词拆分（谨慎使用） #

如果因为某些限制必须用字符串变量，且你能100%确保变量内容安全（没有恶意代码），可以用eval来明确触发单词拆分：

eval gcc "${OPTIONS}" ...

不过要注意，eval会执行变量里的任意命令，存在安全风险，只有当OPTIONS的内容完全由你控制时才建议用这种方式。

总结一下，优先推荐数组写法，既规范又安全；如果必须用字符串变量，加ShellCheck注释禁用警告是最稳妥的选择；eval只作为最后的备选方案。

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