Python 和 Django 编码风格 (PEP)

Question

我使用 Django 框架使用 Python 编写代码。 现在我已经阅读了所有这些编码风格的建议，但遇到了一个模糊的事情。

在这里的 djangoproject 部分 https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/coding-style/#python-style 它说函数 cmets 应该这样说：

这样做，返回那个。

但是，这里http://www.python.org/dev/peps/pep-0257/#one-line-docstrings 说它应该这样说：

这样做，返回那个。

那么，哪个选项是正确的？

Answer 1

PEP 8 跟在第一人称单数之后。 Django 文档标准遵循第三人称单数。前者是标准的。

Answer 2

没有true 代码样式规则。每个框架、库和软件都可以为自己的项目重新定义一些样式规则。

在我的个人代码中，我更喜欢使用更通用的代码样式规则（在本例中为官方 Python 规则），但您应该在文档中指定这一点。