在Shell函数中引用外部关联数组需声明为全局且函数内不重新declare -A，否则会覆盖；可传数组名字符串参数配合间接引用，或用${var[key]+_}判断key是否存在。
在 Shell 函数中引用外部关联数组，关键在于作用域和变量可见性。Bash 默认不支持跨作用域自动继承关联数组（不像普通变量那样可通过 export 传递），所以必须显式处理。
必须先声明为全局，且函数内不重新 declare -A
关联数组默认是全局的，只要没在函数内用 declare -A 或 local -A 重定义同名变量，函数就能直接访问外部已声明并赋值的关联数组。
- 外部定义时务必用
declare -A arr_name显式声明（不能省略） - 函数内不要写
declare -A arr_name，否则会创建一个空的局部同名数组，覆盖外部引用 - 函数内直接使用
${arr_name["key"]}或"${!arr_name[@]}"即可
避免 local -A 意外屏蔽外部数组
如果函数里写了 local -A arr_name，哪怕只是想“暂存”，也会让该名称指向一个全新的空局部数组，导致读不到外部数据。
- 错误示例：
local -A user_info; echo ${user_info["name"]}→ 输出空，不是外部值 - 正确做法：如需局部副本，应显式复制内容：
declare -A local_copy; for k in "${!user_info[@]}"; do local_copy["$k"]="${user_info[$k]}"; done
传参方式（适用于需要隔离或跨脚本场景）
当函数可能被 sourced 到不同上下文，或要确保行为稳定时，推荐把数组名作为字符串参数传入，再用间接引用访问：
- 函数定义：
show_info() { local arr_name="$1"; echo "Name: ${!arr_name[name]}"; } - 调用：
show_info user_info（前提是user_info是已声明的全局关联数组） - 注意：间接引用对关联数组支持有限，
${!arr_name[@]}不可用；更稳妥的是在函数内用eval（慎用）或直接约定只读特定 key
检查是否存在、防静默失败
访问未定义 key 会返回空字符串，容易掩盖问题。建议在函数内加存在性判断：
-
if [[ -n ${user_info["email"+_} ]]; then echo "has email"; fi（利用${var[key]+_}扩展判断 key 是否设置） - 或启用严格模式：
set -u虽不捕获数组 key 未定义，但能防止其他变量误用
