Bash脚本函数间传递数组并执行参数展开时报错排查

这个bad substitution报错的核心问题在于：你试图用普通字符串赋值的方式处理数组，同时函数返回数组的方法不符合bash的语法规则——bash里不能直接用echo返回数组结构，也不能用var=$(func)的形式捕获数组元素。

下面给你两种可行的修正方案，都是基于bash数组引用（local -n）的正确用法：

方案一：通过数组引用直接修改（推荐，效率更高） #

这种方式不需要函数返回值，直接通过引用传递输出数组，在转换函数里直接修改调用方的数组变量：

#!/bin/bash
_convertToRelative() {
    # 第一个参数：输入的绝对路径数组引用
    local -n input_paths=$1
    # 第二个参数：输出的相对路径数组引用
    local -n output_paths=$2
    
    output_paths=()  # 先清空输出数组
    for abs_path in "${input_paths[@]}"; do
        # 去掉路径开头的斜杠，转为相对路径
        output_paths+=("${abs_path#/}")
    done
}

tarPaths() {
    local -n paths_absolute=$1
    local paths_relative=()
    
    # 调用转换函数，传入输入数组和输出数组的引用
    _convertToRelative paths_absolute paths_relative
    
    # 这里可以执行你的tar操作，比如：
    # tar -czf my_archive.tar.gz "${paths_relative[@]}"
    
    # 测试用：打印转换后的相对路径
    echo "转换后的相对路径："
    printf '  %s\n' "${paths_relative[@]}"
}

# 客户端调用示例
paths=( '/foo/bar/baz/a' '/foo/bar/baz/b' '/foo/bar/baz/c' )
tarPaths paths

关键修改点： #

• 用local -n定义输出数组的引用，让转换函数可以直接修改调用方的paths_relative数组
• 用循环逐个处理路径（比原脚本的数组批量替换更直观，也避免了批量替换可能的边界问题）
• 避免了用echo返回数组的错误方式，直接操作数组结构

方案二：通过进程替换+mapfile捕获数组输出 #

如果你坚持要让函数输出转换后的路径，再捕获为数组，可以用mapfile读取函数的逐行输出：

#!/bin/bash
_convertToRelative() {
    local -n input_paths=$1
    for abs_path in "${input_paths[@]}"; do
        # 逐行输出转换后的相对路径
        echo "${abs_path#/}"
    done
}

tarPaths() {
    local -n paths_absolute=$1
    # 用mapfile读取函数的逐行输出，存入数组
    mapfile -t paths_relative < <(_convertToRelative paths_absolute)
    
    # 执行tar操作
    # tar -czf my_archive.tar.gz "${paths_relative[@]}"
    
    # 测试用：打印结果
    echo "转换后的相对路径："
    printf '  %s\n' "${paths_relative[@]}"
}

# 客户端调用示例
paths=( '/foo/bar/baz/a' '/foo/bar/baz/b' '/foo/bar/baz/c' )
tarPaths paths

关键修改点： #

• 转换函数逐行输出每个相对路径，保留数组元素的独立性
• 用mapfile -t结合进程替换< <()，把函数的输出逐行读取到数组中，避免了字符串拼接的问题

原脚本的错误根源： #

1. echo $arr2会把数组元素拼接成一个空格分隔的字符串，丢失了数组的结构（如果路径包含空格，还会被错误拆分）
2. paths_relative=${_convertToRelative paths_absolute}是把函数输出当成单个字符串赋值，而不是数组，这就触发了bad substitution报错，同时根本无法正确存储多个路径元素

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