Shellcheck SC2178警告：declare -n引用数组触发告警是否可忽略

问题对应代码 #

#!/bin/bash
function throwAwayFunc() {
        local _array=();
}

function arraysFromArray() {
  local i _id; _id=$1;
  declare -n _array="${_id}";
#               ^-- SC2178 (warning): Variable was used as an array but is now assigned a string.
  for i in "${_array[@]}"; do
    makeArr "$i";
  done;
}

写法正确性说明 #

你的declare -n写法本身不存在错误。这是Bash 4.3及以上版本正式支持的nameref（名称引用）特性，设计目的就是实现函数间的间接变量引用，完全可以用来传递数组类型参数。只要你的脚本运行环境满足Bash版本要求，且调用该函数时传入的第一个参数是已定义的数组变量名，这段代码的运行逻辑和你的预期一致。

警告触发原因 #

这个警告属于Shellcheck静态分析的局限导致的误报：
Shellcheck没有识别declare -n的nameref语义，扫描时会直接把"${_id}"判定为普通字符串赋值给_array，但后续代码中出现了"${_array[@]}"这种数组专属的变量展开语法，就触发了「变量先作为字符串赋值、后作为数组使用」的SC2178规则。
实际上nameref绑定不会把_array赋值为字符串，只是将其设置为$_id对应原变量的别名，_array的变量类型完全和被引用的原变量保持一致，只要原变量是数组，_array就会以数组类型工作。

警告处理建议 #

• 如果你能确定脚本运行环境为Bash 4.3+，且所有调用arraysFromArray的位置都传入合法的数组变量名，这个误报可以直接忽略，不会影响脚本实际运行。
• 如果需要消除警告，可以在触发警告的代码行上方添加# shellcheck disable=SC2178注释，显式告知Shellcheck跳过该行的对应规则检查即可。

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