Python 代码格式化:重要的规则

Python 代码格式化:重要的规则

Python 是唯一一个格式化即语法的主流语言——缩进错了是崩溃,不是风格问题。这让干净的格式不仅关乎美观,更关乎功能。

日常最重要的规则

  • 每级缩进 4 个空格——社区标准(PEP 8)。制表符可以用,但和空格混用会让解析器出错。
  • 空行:顶层函数和类之前空两行,内部空一行。这就是 Python 代码“呼吸”的方式。
  • 行宽:惯例 79 字符,实践中 88 或 100 也被接受——长行是评审里最常见的风格投诉。
  • 运算符空格:x = 1,不是 x=1;但 f(a, b) 括号内不加空格。
  • 命名:函数和变量用蛇形(snake_case),类用驼峰(CamelCase),常量全大写。

为什么这里格式化更重要

Python 里格式糟糕的代码真的更难调试——缩进就是块结构。少一级或多一级会改变程序行为,而格式化工具能立刻抓住它。

格式化方法

  1. 把代码粘进 Python 格式化工具。
  2. 工具把缩进、空格和换行规范成标准风格。
  3. 复制结果——然后跑一遍,因为格式化不该改变行为,确认这一点正是意义所在。

一句实话

格式化工具套用规则;它不修逻辑。代码原来就是坏的,格式化后还是坏的——只是好看地坏着。但格式化后的代码让 bug 显形,这已经是调试的一半工作。

一致性才是真正的目标:任何格式化方式统一的团队,评审零时间花在风格上,全部时间花在实质上。