踩坑

释义

「坑」指开发中那些文档没写、不易察觉、一不小心就出错的陷阱（如 API 的隐藏限制、版本兼容问题）。「踩坑」即遇到并掉进这些陷阱，「填坑」指解决遗留问题，「避坑」指提前规避，「踩坑记/避坑指南」是技术博客常见题材。[1]

由来

该说法因开发实践中防不胜防的隐蔽问题而普及，是程序员交流经验的核心词汇之一。

用法

例如：「这个库的坑太多了。」再如：「前人挖坑，后人踩坑。」

延伸

「踩坑」与 屎山代码、玄学bug 相关，「踩坑—填坑」循环是工程经验积累的常态。