在Mac终端中开启Debug调试模式需使用set -x启用逐行执行日志，仅对当前会话生效；可运行zsh -x启动独立调试Shell，或组合set -o functrace/set -o errtrace实现函数级深度追踪，亦支持通过env -i与_DEBUG环境变量对特定命令注入调试上下文。
在Mac终端中开启详细的Debug调试模式，是为了让系统命令、Shell脚本或自定义工具输出更底层的执行路径、环境变量变化、函数调用栈及错误溯源信息，避免“命令静默失败”或“报错不明确”导致排查困难。
为当前Shell会话启用全局调试输出
这一步直接激活bash/zsh内置的-x调试标志，所有后续命令将逐行打印实际执行内容（含变量展开后的真实参数）。
在终端中输入：set -x
此时你运行任何命令，比如ls -la ~/Desktop，终端会先显示+ ls -la /Users/yourname/Desktop，再输出结果。该模式仅对当前终端标签页生效，关闭窗口即失效。
退出调试模式只需执行set +x。
启动带调试日志的Shell子进程
当你不想污染当前会话，又需要完整追踪某段脚本行为时，应使用独立调试Shell。此方式能捕获初始化阶段的环境加载细节，比如.profile或.zshrc中的逻辑错误。
方法一：启动调试版zsh（macOS默认Shell）
输入：zsh -x
新Shell启动后自动开启逐行打印，所有命令前缀为+，包括source ~/.zshrc的过程。
方法二：以调试模式运行单个脚本
输入：zsh -x /path/to/your/script.sh
注意：脚本必须有执行权限（chmod +x），且首行无需#!/bin/zsh——-x参数已指定解释器。
深度调试：捕获Shell内部状态与函数调用
仅set -x无法显示函数体内的变量赋值或条件分支走向。要看到每一步变量如何被修改、哪个if分支被选中，需组合使用多个调试选项。
第一步：启用扩展调试标志
执行：set -o functrace; set -o errtrace; set -x
第二步：定义一个测试函数并调用test_func() { local a=1; if [[ $a == 1 ]]; then echo "hit"; fi; }; test_func
第三步：观察输出——你会看到++ test_func、++ local a=1、++ [[ 1 == \1 ]]等精确到语法单元的日志。其中functrace确保函数调用被记录，errtrace让错误也触发调试输出（如command_not_found）。
【关键前提】必须在函数定义前启用functrace，否则函数内部完全静默。
对特定命令注入调试上下文
有时你只想看某条命令的完整执行环境，而非整个Shell会话。这时用env和set组合最精准。
方法一：查看命令启动时的全部环境变量
输入：env -i PATH="$PATH" SHELL="$SHELL" /bin/zsh -c 'set -x; your_command_here'
方法二：临时提升命令的调试粒度（适用于排查make、cmake等复杂构建工具）
输入：YOUR_COMMAND_DEBUG=1 your_command_here
很多开源工具（如Homebrew的brew、Rust的cargo）会识别*_DEBUG环境变量并自动开启详细日志。
注意：不是所有命令都响应_DEBUG变量，需查阅对应工具文档确认支持项。
