用途
该技能面向 Bash 脚本的调试与故障排查，提供 2025 年的最佳实践与系统化方法，帮助开发者定位脚本错误、追踪执行流程、处理异常并验证脚本质量。
主要能力
调试模式技术
- 基础调试模式：使用
set -x开启、set +x关闭调试输出。 - 增强调试输出：通过自定义
PS4变量显示文件名、行号与函数名。 - 条件调试：通过环境变量（如
DEBUG=true）控制调试输出。 - 特定函数调试：使用调试包装函数追踪单个函数的调用与退出码。
追踪与性能分析
- 执行时间剖析：使用
date +%s%N测量函数或命令耗时。 - 函数调用追踪：通过
set -o functrace与trap DEBUG追踪函数调用来源。 - 变量检查：使用
declare -p转储变量，或检查特定变量值。
错误处理与恢复
- 基于 trap 的错误处理器：捕获
ERR信号，输出退出码、文件、行号、函数与调用栈。 - Dry-run 模式：通过
DRY_RUN环境变量模拟执行而不实际运行命令。 - 失败回滚：记录操作并在失败时逆序执行回滚命令。
常见问题与解决方案
- 脚本在交互式环境正常但在 cron 中失败：修复 PATH、设置工作目录、重定向日志。
- 文件名含空格导致脚本失败：使用
IFS= read -r -d ''与find -print0处理。 - 跨系统行为差异：检测平台与工具版本，使用可移植模式。
- 变量作用域问题：区分 local 与全局变量，注意子 shell 作用域。
交互式调试
- 断点模式：在关键操作前暂停，转储变量，可选择进入交互式 shell。
- 监视模式：循环运行脚本并实时查看输出。
日志最佳实践
- 结构化日志：带时间戳与级别（INFO/WARN/ERROR/DEBUG）的日志函数。
- 日志轮转感知：确保日志目录存在且可写，重定向所有输出。
性能调试
- 识别慢命令：通过 PS4 加入时间戳分析每条命令耗时。
- 内存使用追踪：使用
ps监控进程内存。
测试模式
- 单元测试模板：提供断言函数与测试计数器。
- ShellCheck 集成：使用
shellcheck --severity=warning验证脚本。
使用方式
该技能以 Bash 代码片段形式提供各类调试与故障排查模式，开发者可按需复制到脚本中。部分模式通过环境变量（如 DEBUG、DRY_RUN）控制行为。
适用场景
- 调试行为异常的 Bash 脚本。
- 编写生产级 Bash 脚本时加入错误处理与日志。
- 排查 cron 任务、跨平台兼容性、文件名空格等问题。
- 对 Bash 脚本进行性能分析与单元测试。
限制
资料未提供该技能的安装方式、收费模式、平台支持范围或具体效果数据。部分代码示例依赖特定工具（如 ShellCheck、BATS），需用户自行安装。