《游戏引擎实现原理》6.1 调试绘制与运行时可视化
前三卷把 helio 搭到能渲染，但出了问题时你只能盯着屏幕猜。本节做调试绘制：把线框、包围体、法线、拾取射线累积成一条顶点缓冲，L1 单测断言顶点数与排布，L2 在 headless Chromium 里真画出线框，再回读像素验证边线落在正确的屏幕位置。
tag
调试
共 26 篇文章。
GPU 剖析与调试工具链：从帧捕获到计数器与着色器调试
渲染性能优化不能靠猜：必须先用工具定位是 CPU 瓶颈还是 GPU 瓶颈，再细分到填充率、带宽、占用率还是延迟。本文梳理 GPU 剖析与调试的完整工具链，覆盖 RenderDoc/PIX/Nsight 帧捕获、硬件计数器与带宽计算、时间线与异步队列分析、校验层与着色器调试，以及如何在引擎里内置可剖析的 GPU 计时与统计 HUD。
EVM 追踪与调试
从 trace、debug 与 callTracer 三类追踪接口出发，系统讲解 EVM 调试方法：调用树构建与内部转账解析、状态差异与存储槽定位、eth_call 模拟执行与状态覆盖、失败交易的 revert 原因追溯、Gas 消耗的逐指令归因，以及工具链脚本与常见陷阱。
ROS2 实战：话题、服务与动作
ROS2 的三种通信原语各有明确边界：话题用于流式数据、服务用于短同步调用、动作用于长耗时可取消任务。本文给出三者的工程写法、自定义消息设计原则、launch 与参数注入、调试工具链、性能分析与实时调优，以及单元测试与 CI 的落地方式，全部配可运行代码。
工作流可观测与调试
本文讲解工作流引擎的可观测与调试体系，回答实例卡住怎么查、重放失败怎么定位、跨服务链路如何串起来。覆盖实例查询与业务键索引、事件历史与重放调试、TraceContext 透传、工作流级指标设计、关联 ID 与日志、卡住与积压告警、实时状态可视化、流量回放与灰度、成本观测，并给出可落地的查询与配置。
内核调试：kgdb、kdump、crash 与动态追踪
内核调试是系统稳定性保障的最后一道防线。本文系统讲解 kgdb 远程内核调试的配置与串口连接流程，深入分析 panic 与 oops 日志，覆盖 kdump/vmcore 的收集机制与 crash 工具的强大分析能力，以及 printk 日志级别、dynamic debug、ftrace 函数追踪和 bpftrace/kprobe 动态追踪等生产环境常用诊断技术。
GitHub Actions 本地调试与排错：act、workflow_dispatch、日志与重跑
GitHub Actions 本地调试与排错实战：用 act 在本地运行 workflow（镜像选择、密钥注入、artifact 服务、能力边界）、workflow_dispatch 手动触发的 inputs 定义与命令行触发、ACTIONS_STEP_DEBUG 调试日志与 ::debug:: / ::group:: 注解命令、set -x 与 continue-on-error 排查技巧、重跑与日志下载路径、常见错误码含义（exit 137、Resource not accessible）、tmate 交互式排障与速查表
鸿蒙原生应用性能优化与调试
本文按启动、渲染、内存、包体积四条主线梳理 HarmonyOS NEXT 的性能优化：DevEco Profiler 泳道与 hdc、hilog 命令行调试，AppStartup 启动框架与延迟加载，@Reusable 组件复用与 LazyForEach 懒加载，@Track 精确刷新与布局扁平化，内存泄漏排查与快照分析，以及混淆与资源精简。
Nginx 排错与调试实战：错误日志、core dump 与 502/504 故障树
系统梳理 Nginx 排错与调试方法论，覆盖错误日志分级与 debug 编译、core dump 与 gdb 分析、连接状态与 stub_status 排查、502/504/499 故障树以及常见性能陷阱定位。
curl 与 HTTP 调试：请求构造、认证与排错套路
系统讲解 curl 与 HTTP 调试：请求构造（方法、头部、请求体、JSON 与表单）、认证与 Cookie 会话保持、超时与重试的失败语义、连接复用与 DNS 解析细节、TLS 与证书排查、上传下载与进度、代理与抓包（mitmproxy/tcpdump）、性能测量（-w 模板与 time_ 指标）、常见排错套路与速查表。
Defold 性能分析与调试工具链
系统讲解 Defold 性能分析与调试全家桶：内置 Profiler（CPU/GPU/内存）、Draw Call 统计、Lua 内存泄漏排查、消息流量分析、Web Profiler 远程调试、HTML5 调试、日志级别与断言、VS Code 调试集成。
Zig 调试与性能分析：GDB、LLDB、perf 与 Valgrind
系统级编程离不开调试与性能分析。本文系统讲解 Zig 程序在 Debug/ReleaseSafe/ReleaseFast 模式下的调试体验差异、GDB 与 LLDB 断点步进、zig-gdb pretty printers、基于 perf 的采样分析与火焰图、Valgrind memcheck 内存错误定位，以及 std.log 日志级别与崩溃堆栈回溯的实用技巧。
调试技巧与安全防护
系统讲解 set -x 追踪调试与 DEBUG 陷阱断点、常见运行时错误定位，以及引号注入、eval 危险、临时文件与权限等 Shell 脚本安全防护实战。
Lua 剖析与调试工具链：从 luaprofiler 到火焰图
系统搭建 Lua 性能剖析与调试工具链：luaprofiler 采样剖析、debug 库的 hook 与 upvalue 检查、LuaLS 语言服务的静态诊断、busted 集成性能回归，以及用自定义采样器生成性能火焰图的完整思路。
C++ 调试工具链：Sanitizer、Valgrind、静态分析与 ASan/LSan/UBSan
C++ 代码中的内存错误、数据竞争和未定义行为是传统调试手段难以捕捉的隐形杀手。本文系统介绍 AddressSanitizer、ThreadSanitizer、MemorySanitizer、UBSanitizer 等编译器内置工具，配合 Valgrind 和 clang-tidy 静态分析，构建一套从开发到 CI/CD 的完整调试与质量保障工具链。
Node.js 内存泄漏诊断实战
完整讲解 Node.js 内存泄漏诊断：V8 分代 GC 与堆结构、堆快照对比定位、常见泄漏模式（闭包、全局缓存、事件监听器、定时器）、--trace-gc 分析、Chrome DevTools Memory 面板，以及线上兜底策略。
前端性能调试实战：从首屏加载到运行时瓶颈
前端性能调试实战：性能指标体系（FCP/LCP/CLS/TTFB/INP）、加载性能优化（代码分割/懒加载/预加载/Tree Shaking/压缩）、运行时性能（内存泄漏/长任务/事件处理）、网络优化（HTTP/2/3/CDN/缓存策略/图片优化）、性能监控（RUM/Real User Monitoring/Core Web Vitals）、Chrome DevTools 高级用法（Performance/Timeline/Memory/Network/Lighthouse）、性能预算与 CI 集成、常见瓶颈诊断流程。
Nix 构建调试与错误排查：常见错误、trace 与诊断手段
Nix 构建调试与错误排查实战：常见错误分类（哈希不匹配/依赖缺失/语法错误/替换失败）、nix build 调试技巧（--verbose/-L/--show-trace）、builtins.trace 与调试输出、错误定位的思维（缩小到子依赖）、nix-instantiate/nix eval 诊断、store 诊断与 GC 修复、网络与缓存问题、生产排障清单。
Source Map 深入：生成原理、调试体验与错误监控
系统覆盖 Source Map 的底层原理与工程实践：source map 的作用与结构（sources/mappings/names）、VLQ 编码与 mappings 的生成机制、Vite 中 sourcemap 的配置与类型（inline/external/hidden）、浏览器 DevTools 的源码映射与调试体验、sourcemap 上传到错误监控平台（Sentry 等）的实践、生产环境的 sourcemap 安全与策略、以及还原映射与加载性能的权衡，帮助开发者把「调试体验」与「线上可观测性」都做好。
Python 调试与日志工程：从 print 到可观测性
Python 调试与日志工程完整指南：print 调试进阶、pdb/ipdb/breakpoint 交互调试、logging 架构（Logger/Handler/Formatter/Filter）、结构化日志（structlog/JSON）、异常追踪与 traceback、性能剖析、生产可观测性集成。