SuperAPI AI 工具集

debugging

编程与开发

查看项目

更新于 10-16 05:59

技能介绍

用途

该技能是一个面向 Rust 应用的调试专项角色设定,目标是对问题进行系统化调查:收集证据、识别根因并给出清晰解决方案。

核心原则

  • 系统化方法:遵循一致的方法论。
  • 证据驱动:先收集数据,再形成假设。
  • 最小改动:调试时不修改生产行为。
  • 干净交付:完成前移除所有调试代码。

调试方法论

  1. 理解问题:期望行为是什么、实际行为是什么、何时开始出现、是否可复现及如何复现、最近有什么变更。
  2. 收集证据:收集日志与错误信息、确定影响范围(哪些输入、哪些代码路径)、检查模式(时序、负载、数据)、审查近期改动。
  3. 形成假设:列出可能原因、按可能性排序、为每个假设规划测试。
  4. 测试与验证:一次只测试一个假设、记录尝试内容、系统化缩小范围。
  5. 修复与确认:实施最小修复、验证修复是否解决问题、检查回归、移除调试代码。

调试工具

  • 日志:使用 tracing 的 debug!/error!/info!/instrument/span/warn/Level,示例中对 process_data 使用 #[instrument(skip(large_data), fields(data_len = large_data.len()))],并在解析失败时记录错误;investigate_issue 中使用 span 记录 request_id、headers 与 body_size。
  • 调试断言:debug_assert!(index < self.len(), ...) 以及带状态的 debug_assert!(self.is_valid(), ...)。
  • 条件编译:用 #[cfg(debug_assertions)] 定义 debug_dump 输出状态与历史,在非 debug 构建下为空实现。
  • LLDB/GDB:cargo build 后用 rust-lldb target/debug/my-app 启动;常用命令包括 b main、r、n、s、p variable、bt。
  • Miri:rustup +nightly component add miri 安装,cargo +nightly miri test 跑测试,cargo +nightly miri run 跑二进制。

常见问题模式

  • 竞态条件:症状为间歇性失败、每次运行结果不同;可通过带线程 ID 的日志、线程 sanitizer(RUSTFLAGS="-Z sanitizer=thread" cargo +nightly run)、检查同步与锁作用域排查。
  • 内存问题:症状为崩溃、损坏、valgrind 报错;可用地址 sanitizer(RUSTFLAGS="-Z sanitizer=address" cargo +nightly run)、检查 unsafe 指针与生命周期、使用 Miri 检测 UB。
  • 性能问题:症状为变慢、CPU/内存偏高;可用 cargo flamegraph 分析、加入 Instant 计时日志、用 heaptrack 或 Instruments 检查分配。
  • 异步死锁:症状为任务永久挂起;可用 tokio::time::timeout 包装并记录超时错误、用 tokio-console 检查运行时状态,并排查异步上下文中的阻塞调用、循环 await 依赖、通道满/空死锁。

调试报告模板

包含问题摘要、复现步骤、环境(Rust 版本、操作系统、相关依赖)、调查(收集的证据、测试过的假设、根因)、解决方案(改动文件与描述、验证方式)、预防措施。

约束与成功指标

约束:完成前移除所有调试代码;调试时不修改生产行为;记录所有测试过的假设;提供最小复现用例;给出预防建议。成功指标:识别根因、修复经验证有效、不遗留调试代码、有清晰的调查记录、添加回归测试。

限制

该页面未提供该技能的安装命令、收费或价格信息、支持的平台范围等事实,暂未提供。