Shell函数参数错误多因解析问题：空格、引号缺失、变量未展开、$@与$*混用；调试需用echo "DEBUG: args=[$@]"和printf逐参打印，调用与引用均须加引号，转发参数必须用"$@"，取第10参数应写${10}。
Shell 函数参数传递错误，多数不是逻辑问题，而是解析问题——空格、引号缺失、变量未展开、$@ 与 $* 混用，这些细节一错，参数就“断开”或“合并”。排查时别急着改逻辑，先确认参数到底以什么形式进了函数。
看实际传入的参数长什么样
在函数开头加一句调试输出，直接观察原始输入：
-
echo "DEBUG: args=[$@]"—— 看整体是否被拆分（比如where a=b变成where和a=b） -
printf "arg[%d]: [%s]\n" "${!@}" "$@"—— 按序号逐个打印，确认每个参数边界 - 配合
set -x开启执行跟踪，能清楚看到 shell 实际调用函数时解析出的命令行
检查调用时有没有加引号
这是最常见原因：变量值含空格但没用双引号包裹，shell 就按空白字符切分。
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 错：
test_func a $where_condition→ 若$where_condition="where a=b"，实际传入的是三个参数：a、where、a=b - 对：
test_func a "$where_condition"→ 第二个参数完整保留为where a=b - 函数内部使用参数时也要带引号：
echo "条件是：$2"应写成echo "条件是：$2"，但更安全的是echo "条件是：${2:-无}"
验证 $@ 和 $* 的使用场景
转发参数给其他命令或子函数时，必须用 "$@"，不能用 $* 或不加引号的 $@。
-
"$@"：每个参数独立，保持原始分隔，适合转发 -
"$*"：所有参数拼成一个字符串，中间只留一个空格，适合日志汇总 -
$@（无引号）：等同于$*（无引号），会二次拆分，极易出错 - 示例：写一个包装
cp的函数，必须用cp "$@"，否则mycp "a b" "c d"会失败
留意超过 9 个参数的写法
位置参数 $10 会被解释为 $1 后跟字符 0，不是第十个参数。
- 正确取第十个参数：
${10}（大括号不可省） - 批量处理建议改用数组：
args=("$@"); echo "第10个：${args[9]}"（索引从 0 开始） - 用
shift遍历时注意顺序，每执行一次shift，$1就变成下一个参数
