最精准、干扰最小的调试方法是在函数内部局部启用 set -x：在函数首行加 set -x、末尾加 set +x，配合 ps4 显示行号；用 trap 捕获 err 并打印函数名、行号和退出码；开头回显参数、关键处输出变量；对副作用强的函数可用子 shell 隔离调试。
直接在函数内部启用调试，而不是全局开 set -x，是最精准、干扰最小的做法。
在函数开头手动开关调试跟踪
把 set -x 和 set +x 包裹在目标函数体中，只让该函数执行时输出命令展开细节：
- 在函数第一行加
set -x，末尾加set +x - 配合
PS4='[$LINENO] '可同时显示行号，方便定位到函数内哪一行出问题 - 避免影响其他函数或主流程，尤其当脚本含敏感变量（如密码）时，局部开启更安全
用 trap 捕获函数内错误上下文
在函数内部设置临时 trap，专门捕获该函数范围内的失败：
- 写法示例：
trap 'echo "ERR in func: $FUNCNAME, line $LINENO, exit code $?" >&2' ERR -
$FUNCNAME自动指向当前函数名，$LINENO是函数内错误发生的行号（非整个脚本的绝对行号） - 建议搭配
set -e或显式检查命令返回值（如grep ... || return 1），确保错误能触发 trap
结合变量快照与参数回显
调试复杂函数常需确认输入是否符合预期、中间变量是否被意外修改：
- 开头打印参数：
echo "DEBUG: $FUNCNAME called with: $*" - 关键步骤后输出变量：
echo "DEBUG: var_x=$var_x, status=$?" - 若需导出全部局部变量，可在 trap 或调试段落中运行
declare -p | grep "^local\|^$FUNCNAME"（注意：local变量在函数外不可见，declare -p在函数内才有效）
用子 shell 隔离调试环境
对副作用强、状态易污染的函数，可将其放入子 shell 执行并单独调试：
- 写法：
(set -x; your_function arg1 arg2) - 子 shell 中的
set -x不影响父脚本，退出后自动恢复 - 适合测试函数逻辑独立性，也便于重定向调试输出：
(set -x; your_function) 2> /tmp/func_debug.log
