如何转义命令行以生成可复用的zsh脚本调试日志？

我在调试zsh脚本时，希望回显正在执行的命令，方便直接复制到提示符中运行。脚本原代码如下：

negate() {
    echo \( "$1" -negate \)
}
NEGATED_IMAGE="$(negate 'my image.png')"
convert $=NEGATED_IMAGE two.png -composite out.png

我尝试在执行命令前添加echo记录，但生成的日志是：

convert ( my image.png -negate ) two.png -composite out.png

这个日志无法直接执行——括号没转义，带空格的my image.png也没被引号包裹。我需要的理想日志是：

convert \( 'my image.png' -negate \) two.png -composite out.png

要生成能直接复制执行的命令日志，关键是让带空格、括号的参数都被正确转义，同时还要修复原脚本里参数拆分的问题——原来的$=NEGATED_IMAGE会把带空格的文件名拆成两个参数，本身就会导致convert执行出错。

方法一：用数组管理命令参数（推荐） #

数组能完整保留带空格的参数，避免拆分错误，配合zsh的转义功能可生成正确日志：

# 改写negate函数，输出转义后的参数片段
negate() {
    local img="$1"
    # ${(q)img}会自动转义文件名里的特殊字符（比如空格）
    printf "%s " "\(" "${(q)img}" "-negate" "\)"
}

# 把命令片段存为数组
NEGATED_PARMS=($(negate 'my image.png'))

# 构建完整的命令数组
cmd=(convert $NEGATED_PARMS two.png -composite out.png)

# 输出可直接执行的日志
print -r -- ${(q)cmd[@]}
# 执行命令
$cmd

方法二：直接转义现有参数（改动小） #

如果不想大改脚本结构，可以直接在输出日志时对拆分后的每个参数做转义：

negate() {
    echo \( "$1" -negate \)
}
NEGATED_IMAGE="$(negate 'my image.png')"

# ${(q)=NEGATED_IMAGE}先按$=拆分参数，再逐个转义特殊字符
print -r -- convert ${(q)=NEGATED_IMAGE} two.png -composite out.png
# 执行原命令
convert $=NEGATED_IMAGE two.png -composite out.png

两种方法最终都会输出你需要的理想日志：

convert \( 'my image.png' -negate \) two.png -composite out.png

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