“Python游标卡尺”是调侃缩进嵌套过深的代码，因Python用空格/TAB作语法边界，多层if/for/try嵌套致可读性差、易出错，核心在于缩进兼具语法、格式与协作三重负担。
“Python游标卡尺”是个程序员圈内调侃梗，不是真指测量工具，而是讽刺某些Python代码缩进层次多、嵌套过深，像游标卡尺的精密刻度一样——一层套一层，密密麻麻，肉眼难数、手抖易错。
为什么叫“游标卡尺”？
游标卡尺靠主尺+游标双刻度对齐读数，精度高但读起来费劲；类比到Python代码，就是靠空格或Tab的缩进层级来定义逻辑块，没有{}或end作视觉锚点。当函数里套if，if里套for，for里套try，再塞个match-case……缩进到了8、10甚至12层，人眼看不出哪段属于哪个块，编辑器也难自动对齐——就像拿着游标卡尺数毫米线，得屏息、对光、反复核对。
核心痛点其实是“空白符带语义”
- 缩进不是纯样式，而是语法的一部分：少一个空格就
IndentationError，多一个Tab可能就逻辑错位 - 复制粘贴时，源代码缩进风格（4空格/Tab/混合）和目标上下文不一致，IDE无法像大括号语言那样“看括号就重排”，只能手动调、反复试
- 旧代码或协作项目中，有人写到5层嵌套还不拆函数，新人加一行就得先数清前面有几个空格，再决定该缩进多少
这不是反对缩进，是反对缩进承担太多
大家认可缩进提升可读性，但问题出在：它同时兼任了“语法界定符”“格式标记”“协作契约”三重角色。而现代编辑器早就能自动管理格式，真正需要机器推导的，应该是结构本身——比如用{}或end明确边界，缩进只负责好看。Python当年为适应1991年的文本编辑器做了取舍，今天再照搬，就有点像用算盘跑Excel。
怎么避免写成“游标卡尺”？
- 单个函数嵌套别超3层，超过就抽成新函数（哪怕只调一次）
- 用
guard clause提前返回，减少if嵌套（比如先检查参数无效就retu
rn，而不是包在if里写正文） - 善用
pathlib、dataclasses、生成器等减少样板嵌套 - 粘贴代码前，用编辑器“清除缩进”或“转为制表符/空格统一”，再按当前上下文重新缩进
rn，而不是包在if里写正文）
