python - Python 和 Django 编码风格 (PEP)

Question

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

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

这样做，返回那个。

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

这样做，返回。

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

Answer 1

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

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

Answer 2

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