[纸上调试](https://docs.pingcode.com/baike/tag/%e7%ba%b8%e4%b8%8a%e8%b0%83%e8%af%95)是我非常喜欢的一种代码调试方法。它几乎可以说是最“低技术含量”的方式，但效果却常常出奇地好。

[![纸上调试是什么？一种简单有效的代码调试方法](https://cdn-docs-new.pingcode.com/baike/wp-content/uploads/2026/06/20260601175105753-1024x683.png)](https://cdn-docs-new.pingcode.com/baike/wp-content/uploads/2026/06/20260601175105753-1024x683.png)

## **如何进行纸上调试**

你只需要一支笔和一张纸，或者一块白板。先写下代码中的关键变量，然后在脑海中逐行执行代码。每当变量发生变化，就把变化记录下来。如果中途卡住了，可以请别人和你一起推演，确认你对代码执行过程的理解是否正确。

即使你可以使用调试器，纸上调试依然很有价值。你可以先在纸上推演一遍，再运行调试器，对照实际执行过程，检查自己脑海中的模型是否准确。这样做不仅有助于定位问题，还能加深你对代码的理解，并训练你的批判性思维能力。

## **为什么纸上调试有效**

我发现，帮助别人调试代码时，最有效的方法之一，就是和对方一起做纸上调试。我通常会拿出纸和笔，然后问对方：

“你能用方框和箭头画出这段代码的执行过程吗？顺便解释一下它应该如何运行，以及你觉得哪里可能出错。尽量用一种我也能理解的方式讲出来。”

这个方法看似简单，却能迫使人们从过于局部的细节中抽离出来，在脑海里，也在纸面上，重新梳理代码的整体运行逻辑。

最坏的情况是，问题依然没有解决，但我至少也理解了问题是什么，以及它可能出在哪里。

而在很多情况下，调试的人会在解释过程中突然“恍然大悟”，自己发现真正的问题所在。

对于团队来说，纸上调试不只是一种临时排查问题的方法，也可以成为知识沉淀的一部分。比如在复杂问题定位后，团队可以将关键变量变化、错误原因、排查路径和最终解决方案记录到 Wiki 中。像 [[PingCode](https://PingCode.com?utm_source=insights&utm_medium=%E5%93%81%E7%89%8C%E8%AF%8D)](https://sc.pingcode.com/dxsxk) 这样的智能化研发管理工具，可以把需求、开发、测试、发布以及 Wiki 知识沉淀串联起来，让一次调试经验转化为团队后续排查类似问题时可复用的知识资产。

你上一次用纸，或者白板，来调试代码是什么时候？