当编写Django代码时，请遵从这些编码标准。
\nPlease conform to the indentation style dictated in the .editorconfig\nfile. We recommend using a text editor with EditorConfig support to avoid\nindentation and whitespace issues. The Python files use 4 spaces for\nindentation and the HTML files use 2 spaces.
除非另有约定的情况下，否则遵从 PEP8 编码规范。
\nUse flake8 to check for problems in this area. Note that our setup.cfg\nfile contains some excluded files (deprecated modules we don't care about\ncleaning up and some third-party code that Django vendors) as well as some\nexcluded errors that we don't consider as gross violations. Remember that\nPEP 8 is only a guide, so respect the style of the surrounding code as a\nprimary goal.
An exception to PEP 8 is our rules on line lengths. Don't limit lines of\ncode to 79 characters if it means the code looks significantly uglier or is\nharder to read. We allow up to 119 characters as this is the width of GitHub\ncode review; anything longer requires horizontal scrolling which makes review\nmore difficult. This check is included when you run flake8. Documentation,\ncomments, and docstrings should be wrapped at 79 characters, even though\nPEP 8 suggests 72.
使用四个空格作为缩进。
使用四个空格的悬挂缩进而不是垂直对齐。
\nraise AttributeError(\n 'Here is a multiline error message '\n 'shortened for clarity.'\n)\n替换为：
\nraise AttributeError('Here is a multiline error message '\n 'shortened for clarity.')\n这样能更好的利用空间，而且可以避免当第一行长度变化时需要重新对齐。
\nUse single quotes for strings, or a double quote if the string contains a\nsingle quote. Don't waste time doing unrelated refactoring of existing code\nto conform to this style.
Avoid use of "we" in comments, e.g. "Loop over" rather than "We loop over".
在给变量，函数和方法命名时候使用下划线而不是小驼峰 (例如： poll.get_unique_voters(), not poll.getUniqueVoters() )。
类名使用“大驼峰命名法”（或者是用在能返回类的工厂函数上面）。
对于文档字符串，遵从现有文档字符串风格和 PEP257 规范。
In tests, use\nassertRaisesMessage() and\nassertWarnsMessage()\ninstead of assertRaises() and\nassertWarns() so you can check the\nexception or warning message. Use assertRaisesRegex()\nand assertWarnsRegex() only if you need regular\nexpression matching.
In test docstrings, state the expected behavior that each test demonstrates.\nDon't include preambles such as "Tests that" or "Ensures that".
\nReserve ticket references for obscure issues where the ticket has additional\ndetails that can't be easily described in docstrings or comments. Include the\nticket number at the end of a sentence like this:
\ndef test_foo():\n """\n A test docstring looks like this (#123456).\n """\n ...\n通过下面的指引使用 isort 自动给导入语句排序。
\nQuick start:
\nLinux / macOS
$ pip install isort\n$ isort -rc .\nWindows
...\\> pip install isort\n...\\> isort -rc .\n这将从你的当前目录递归运行 isort ，修改所有不符合指引的文件，如果你不需要排序（例如：避免循环导入）请在你的导入里面像这样加上注释：
import module # isort:skip\n把导入这样进行分组：future库，python标准库，第三方库， 其他的Django组件，本地Django组件，try/excepts块。按照字母顺序对每个分组进行排序，按照完整的模块名称。在每个分组里面把import module句子放在 from module importobjects句子前面。对于其他Django组件使用绝对导入，对本地Django组件使用相对导入。
On each line, alphabetize the items with the upper case items grouped before\nthe lowercase items.
使用括号和4个连续空格构成的缩进去打破长行，在最后一个导入之后写一个逗号，把右括号放在单独一行。
\n在最后一个导入和任何代码块之间留出一个空行，在第一个函数或类前面留出两个空行。
\n例如（注释仅作为解释用途）：
\n# future\nfrom __future__ import unicode_literals\n\n# standard library\nimport json\nfrom itertools import chain\n\n# third-party\nimport bcrypt\n\n# Django\nfrom django.http import Http404\nfrom django.http.response import (\n Http404, HttpResponse, HttpResponseNotAllowed, StreamingHttpResponse,\n cookie,\n)\n\n# local Django\nfrom .models import LogEntry\n\n# try/except\ntry:\n import yaml\nexcept ImportError:\n yaml = None\n\nCONSTANT = 'foo'\n\n\nclass Example:\n # ...\n尽可能使用便利的导入，例如：这样做
\nfrom django.views import View\n替换成：
\nfrom django.views.generic.base import View\nIn Django template code, put one (and only one) space between the curly\nbrackets and the tag contents.
\n这样做：
\n{{ foo }}\n不要这样做：
\n{{foo}}\n在Django的视图中，第一个参数应该总是 request 。
这样做：
\ndef my_view(request, foo):\n # ...\n别这样做：
\ndef my_view(req, foo):\n # ...\n字段名称应当全部使用小写，使用下划线替代驼峰命名。
\n这样做：
\nclass Person(models.Model):\n first_name = models.CharField(max_length=20)\n last_name = models.CharField(max_length=40)\n别这样做：
\nclass Person(models.Model):\n FirstName = models.CharField(max_length=20)\n Last_Name = models.CharField(max_length=40)\n class Meta 类应该位于定义字段之后，用一个空行分割字段定义和类定义。
这样做：
\nclass Person(models.Model):\n first_name = models.CharField(max_length=20)\n last_name = models.CharField(max_length=40)\n\n class Meta:\n verbose_name_plural = 'people'\n别这样做：
\nclass Person(models.Model):\n first_name = models.CharField(max_length=20)\n last_name = models.CharField(max_length=40)\n class Meta:\n verbose_name_plural = 'people'\n不要这样做，也不要这样做。。。。。。
\nclass Person(models.Model):\n class Meta:\n verbose_name_plural = 'people'\n\n first_name = models.CharField(max_length=20)\n last_name = models.CharField(max_length=40)\n模型内的类核方法的定义应该遵循以下顺序（不是所有项都是必须的）：
\n所有数据库字段
自定义管理器属性
class Meta
def __str__()
def save()
def get_absolute_url()
其他自定义方法
If choices is defined for a given model field, define each choice as a\nlist of tuples, with an all-uppercase name as a class attribute on the model.\nExample:
class MyModel(models.Model):\n DIRECTION_UP = 'U'\n DIRECTION_DOWN = 'D'\n DIRECTION_CHOICES = [\n (DIRECTION_UP, 'Up'),\n (DIRECTION_DOWN, 'Down'),\n ]\ndjango.conf.settingsLink to this heading#Modules should not in general use settings stored in django.conf.settings\nat the top level (i.e. evaluated when the module is imported). The explanation\nfor this is as follows:
Manual configuration of settings (i.e. not relying on the\nDJANGO_SETTINGS_MODULE environment variable) is allowed and possible as\nfollows:
from django.conf import settings\n\nsettings.configure({}, SOME_SETTING='foo')\nHowever, if any setting is accessed before the settings.configure line,\nthis will not work. (Internally, settings is a LazyObject which\nconfigures itself automatically when the settings are accessed if it has not\nalready been configured).
So, if there is a module containing some code as follows:
\nfrom django.conf import settings\nfrom django.urls import get_callable\n\ndefault_foo_view = get_callable(settings.FOO_VIEW)\n...then importing this module will cause the settings object to be configured.\nThat means that the ability for third parties to import the module at the top\nlevel is incompatible with the ability to configure the settings object\nmanually, or makes it very difficult in some circumstances.
\nInstead of the above code, a level of laziness or indirection must be used,\nsuch as django.utils.functional.LazyObject,\ndjango.utils.functional.lazy() or lambda.
Mark all strings for internationalization; see the i18n\ndocumentation for details.
flake8将为你识别删除更改代码时不再使用的import语句，如果因为向后兼容的原因需要保留导入，则可以在导入语句后面加上# NOQA消除flake8的警告。
按部就班的删除代码结尾那些增加不必要字节的空格，增加了显示混乱还可能导致偶尔的合并冲突。一些IDE可以通过配置自动删除它们，大多数版本控制工具可以在差异比较时高亮显示它们。
请不要在你贡献的代码里面放入你的名字，我们的政策是把贡献者名字保存到随Django分发的AUTHORS文件里--—而不是分散在代码库里。如果你进行的不只是一次简单修改，请随意更改在你补丁中的AUTHORS文件。
For details about the JavaScript code style used by Django, see\nJavaScript.
\n