PEP 8 中命名约定的首要原则是什么？

Question

在PEP 8 Style Guide for Python Code 中，命名约定下列出的第一条规则是覆盖原则。

优先原则

作为 API 公共部分对用户可见的名称应遵循反映用法而不是实现的约定。

PEP 指南没有提供任何额外的细节或示例，这让我不确定这条规则的实际含义。

PEP 8 中的首要原则是什么？该规则何时适用？

Answer 1

Python 的首要原则是您应该能够查看代码并知道它的作用，而无需阅读任何其他代码。Python 鼓励“显式而不是隐式”，所以写得好的 Python 代码应该是显而易见的。不应该有任何隐含的功能，并且所有内容的命名方式都应该让您不会对其所做的事情感到惊讶。