【Linux 基础知识系列：第二百一十九篇】Bash 关联数组（字典）的使用-编程阁

一、简介：为什么必须学会关联数组？

在日常脚本开发中，我们经常会遇到“键-值”型数据：

根据主机名找 IP
根据用户名查邮箱
统计每个 URL 的出现次数

使用普通数值索引数组（arr[0]=alice）需要手工维护映射表，既麻烦又容易出错。
Bash 4.0 起内置关联数组（Associative Array），功能等价于其他语言的“字典（Dictionary）”或“Map”：

键可以是任意字符串，不再局限于 0 1 2 …
读写速度 O(1)，脚本依然轻量
无需额外安装软件，比外部调用 awk/sed 更快速、可读性更高

掌握关联数组，让你的脚本从“玩具级”跃升到“工程级”。

二、核心概念：一张表看懂关联数组

术语	说明	示例
关联数组	键→值的映射表	`declare -A site=( [google]="216.58.200.46" )`
键（key）	唯一字符串	`google`
值（value）	任意字符串	`216.58.200.46`
声明	告诉 Bash 这是关联数组	`declare -A arr`
遍历	逐个访问键/值	`for key in "${!arr[@]}"`

注意： Bash 3 及以下不支持，macOS 默认 Bash 3 需brew install bash。

三、环境准备：2 分钟搞定

检查版本

bash --version | head -1 # ≥ 4.0 即可

若 < 4.0（CentOS 7、macOS 默认）

# CentOS sudo yum install -y bash # macOS brew install bash

进入实验目录
```
mkdir -p ~/bash-dict && cd ~/bash-dict
```

四、命令与示例：从定义到遍历，一站式 copy & run

以下脚本均保存为demo.sh，直接chmod +x demo.sh && ./demo.sh即可看到结果。

4.1 声明与赋值

#!/usr/bin/env bash # demo1.sh declare -A config # ① 声明关联数组 config[host]="192.168.1.10" # ② 赋值 config[user]="root" config[port]="22" echo "主机=${config[host]}" # ③ 读取 echo "用户=${config[user]}"

输出：

主机=192.168.1.10 用户=root

4.2 一次批量赋值（花括号法）

#!/usr/bin/env bash # demo2.sh declare -A color=( [red]="#FF0000" [green]="#00FF00" [blue]="#0000FF" ) echo 红色代码=${color[red]}

4.3 安全读取：防未定义键

#!/usr/bin/env bash # demo3.sh declare -A cfg cfg[timeout]=30 # 如果键不存在返回默认值 timeout=${cfg[timeout]:-60} # ← 60 是默认值 echo "超时时间=$timeout"

4.4 遍历键与值

#!/usr/bin/env bash # demo4.sh declare -A score=( [alice]=90 [bob]=80 [carol]=85 ) # 遍历键 for name in "${!score[@]}"; do echo "$name 分数是 ${score[$name]}" done

技巧：

"${!score[@]}"取全部键
"${score[@]}"取全部值
顺序与插入顺序无关（哈希实现）

4.5 计数器：统计单词出现次数

#!/usr/bin/env bash # demo5.sh declare -A counter while read -r word; do ((counter[$word]++)) # 不存在时自动初始为 0 done < <(echo "apple apple banana apple") for w in "${!counter[@]}"; do echo "$w 出现了 ${counter[$w]} 次" done

输出：

apple 出现了 3 次 banana 出现了 1 次

4.6 修改与删除

#!/usr/bin/env bash # demo6.sh declare -A site site[google]="216.58.200.46" # 修改 site[google]="142.250.185.78" echo "新 IP=${site[google]}" # 删除 unset site[google] [[ -v site[google] ]] && echo "仍存在" || echo "已删除"

4.7 长度与判空

echo "键数量=${#config[@]}" [[ ${#config[@]} -eq 0 ]] && echo "数组为空"

4.8 嵌套模拟（二维键）

Bash 不支持真正的二维数组，可用拼接键技巧：

declare -A matrix matrix[1,1]=10 matrix[1,2]=20 echo "${matrix[1,2]}" # 输出 20

4.9 与配置文件联动：一行导入

# config.txt 内容： # host=192.168.1.10 # user=root # port=22 declare -A cfg while IFS='=' read -r key value; do cfg[$key]=$value done < config.txt echo "导入完成，主机=${cfg[host]}"

4.10 函数返回值：返回字典

# 返回多个值的最佳实践 function get_dbinfo() { local -A db db[host]="localhost" db[port]=3306 db[user]="admin" # 打印键值对，调用者用 eval 重建 for k in "${!db[@]}"; do echo "$k=${db[$k]}" done } # 调用端 declare -A dbinfo while IFS='=' read -r k v; do dbinfo[$k]=$v done < <(get_dbinfo) echo "数据库端口=${dbinfo[port]}"

五、常见问题与解答（FAQ）

问题	现象	解决
`declare -A`报错“invalid option”	Bash < 4.0	升级 Bash，`brew install bash`/`yum install bash`
键顺序乱	与插入顺序不同	关联数组底层哈希，排序用 `for k in (printf′{!arr[@]}"	sort)`
空格被截断	`arr[key]=val ue`	双引号包裹：`arr[key]="val ue"`
变量未定义却返回 0	`((${counter[$word]}++))`	这是预期行为；若需严格判空先用`[[ -v counter[$word] ]]`
macOS 默认 sh 不支持	`#!/bin/sh`失败	shebang 写`#!/usr/bin/env bash`且确保新 bash 路径在`/etc/shells`

六、实践建议与最佳实践

统一封装：把常用读配置写成函数，避免全局变量污染。
默认安全：读取加:-默认值，脚本在 CI 里更健壮。
大文件提速：>10 万键时，用外部 SQLite；Bash 数组仍轻量，但别滥用。
命名规范：全大写表示常量，例declare -A CONFIG=()。

调试技巧：

declare -p arr # 打印完整键值对，排错神器

兼容考虑：若脚本需支持 Bash 3，回退到awk关联数组，但放弃 Bash 原生。

七、总结：一张脑图带走全部要点

Bash 关联数组 ├─ 声明：declare -A arr ├─ 赋值：arr[key]=val / 批量 ( [k]=v ) ├─ 读取：${arr[key]} / ${arr[key]:-default} ├─ 遍历：for k in "${!arr[@]}" ├─ 计数：((arr[key]++)) └─ 技巧：config 文件一键导入、函数返回字典

掌握关联数组，你的脚本就能：