Bash关联数组多条目返回值异常问题及版本兼容说明

正如多条评论指出，Bash 2或Bash 3不支持关联数组。本帖关闭，下文说明我们如何解决原本试图用关联数组处理的问题。

我们在项目的def.sh文件中声明Bash数组，代码如下：

#!/bin/bash

declare -a map=
(
    ["Key_A"]='Val_A'
    ["Key_B"]='VAL_B'
)

在终端中通过source def.sh加载该文件，随后通过如下方式访问数组元素：

export var_a="xyz"

var_b="${map[${var_a}]}"

这样实现的原因与我们使用的内部系统及项目需求相关。

当初始数组仅含一个条目时一切正常，但添加第二个条目后，数组始终返回最后一个条目的值。例如执行：

export var_a="Key_A"

var_b="${map[${var_a}]}"

执行echo ${var_b}输出VAL_B，而调用"${map[KEY_B]}"同样返回VAL_B。我们尝试直接使用"${map[KEY_A]}"（不带参数替换），无论是否加引号，结果一致。

请问这是什么原因导致的？

我们尝试使用declare -A map=(，结果报错：

bash: declare: -A: invalid option
declare: usage: declare [-afFirtx] [-p] [name[=value] ...]

help declare的输出如下：

declare: declare [-afFirtx] [-p] [name[=value] ...]
    Declare variables and/or give them attributes.  If no NAMEs are
    given, then display the values of variables instead.  The -p option
    will display the attributes and values of each NAME.
    
    The flags are:
    
      -a    to make NAMEs arrays (if supported)
      -f    to select from among function names only
      -F    to display function names (and line number and source file name if
        debugging) without definitions
      -i    to make NAMEs have the `integer' attribute
      -r    to make NAMEs readonly
      -t    to make NAMEs have the `trace' attribute
      -x    to make NAMEs export
    
    Variables with the integer attribute have arithmetic evaluation (see
    `let') done when the variable is assigned to.

原因 #

问题核心有两点：

1. declare -a声明的是索引数组，而非关联数组。在Bash中，索引数组的下标会被强制解析为整数，非整数下标会自动转换为0。因此["Key_A"]和["Key_B"]都会被当作下标0处理，后面的赋值覆盖了前面的内容，最终数组下标0的值固定为VAL_B——不管用什么字符串下标访问，实际都是取下标0的内容。
2. 你的Bash版本不支持关联数组（Bash 4及以上版本才支持declare -A），从help declare的输出中看不到-A选项，也验证了这一点。

替代解决方案 #

既然无法使用原生关联数组，推荐以下几种模拟方式：

方式1：使用case语句映射键值 #

通过函数封装键值匹配逻辑：

# 在def.sh中定义函数
get_map_value() {
    case "$1" in
        "Key_A") echo "Val_A" ;;
        "Key_B") echo "VAL_B" ;;
        *) echo "" ;; # 可自定义默认值
    esac
}

# 调用示例
export var_a="Key_A"
var_b=$(get_map_value "$var_a")

方式2：使用环境变量间接引用 #

给每个键值对定义带前缀的环境变量，通过间接引用获取值：

# 在def.sh中定义
export map_Key_A="Val_A"
export map_Key_B="VAL_B"

# 访问示例
export var_a="Key_A"
var_b="${!map_${var_a}}" # 间接引用语法：${!变量名}

方式3：使用awk处理键值对 #

将键值对存储为文本，通过awk匹配取值：

# 在def.sh中存储键值对内容
map_content=$(cat <<EOF
Key_A Val_A
Key_B VAL_B
EOF
)

# 定义取值函数
get_map_value() {
    echo "$map_content" | awk -v key="$1" '$1 == key {print $2}'
}

# 调用示例
export var_a="Key_B"
var_b=$(get_map_value "$var_a")

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