我们始终感谢对Django代码的贡献。事实上，具有相关贡献的错误报告将得到修复 far 比那些没有解决方案的人更快。
如果您正在修复一个非常小的问题，例如更改文档中的一个单词，提供补丁的首选方法是使用不带trac票据的github pull请求。
见 使用Git和Github 有关如何使用拉请求的详细信息。
在一个开源项目中，世界上有数百个贡献者，有效地管理沟通是很重要的，这样工作就不会重复，贡献者就可以尽可能的有效。
因此，我们的策略是为“索赔”票据的贡献者提供服务，以便让其他开发人员知道正在处理某个特定的bug或特性。
如果您已经确定了您想要做出的贡献，并且能够修复它（根据您的编码能力、Django内部知识和时间可用性来衡量），请按照以下步骤进行声明：
Login using your GitHub account 或 create an account 在我们的票务系统中。如果您有帐户但忘记了密码，可以使用 password reset page .
如果此问题的票证还不存在，请在我们的 ticket tracker .请记住，新功能的提案应遵循 process for suggesting new features .
如果此问题的票已经存在，请确保没有其他人认领它。要执行此操作，请查看票据的“所有者”部分。如果它被分配给“无人”，那么它就可以被索赔。否则，其他人可能正在处理这张票。或者找到另一个要处理的bug/特性，或者联系处理票据的开发人员以提供帮助。如果一张票被分配了几个星期或几个月没有任何活动，那么重新分配给自己可能是安全的。
如果您还没有登录您的帐户，请点击票务页面左上角的“GitHub登录”或“DjangoProject登录”。登录后，您可以点击页面底部附近的“修改门票”按钮。
单击“操作”部分中的“分配给”弹出式按钮领取门票。默认情况下，您的用户名将填写在文本框中。
最后点击底部的“提交更改”按钮保存。
备注
Django软件基金会要求任何贡献超过 trivial change ，向姜戈签署并提交一份 Contributor License Agreement ，这确保了Django Software Foundation对所有贡献拥有明确的许可，从而为所有用户提供明确的许可。
一旦你认领了一张票，你就有责任以一种合理及时的方式处理这张票。如果你没有时间来处理它，要么不理睬它，要么一开始就不认领它！
如果在一两周内某个特定的已申领车票没有进展的迹象，另一个开发商可能会要求您放弃该车票申领，这样它就不再被垄断，其他人也可以申领。
如果您已经申领了一张票，并且要花很长时间（几天或几周）来编码，那么通过在票上发表评论来保持每个人的更新。如果您没有提供定期更新，并且没有对进度报告的请求作出响应，那么您在通知单上的索赔可能会被撤销。
像往常一样，多沟通总比少沟通好！
在某些情况下，经历领取门票的步骤是矫枉过正的。
如果发生小更改，例如文档中的拼写错误或只需几分钟即可修复的小错误，您不需要跳过索取门票的程序。直接提交您的更改即可完成！
它是 always 无论是否有人声称，如果您恰好准备好更改，将提案链接到票证都是可以接受的。
确保您所做的任何贡献至少满足以下要求：
修复问题或添加功能所需的代码是解决方案的重要组成部分，但它不是唯一的部分。一个好的修复还应该包括 regression test 验证已修复的行为并防止问题再次出现。此外，如果某些票证与您编写的代码相关，请在测试中的一些评论中提及票证号码，以便在您的补丁提交并且票证关闭后可以轻松地追溯相关讨论。
如果代码添加了新功能，或修改了现有功能的行为，则更改还应该包含文档。
当您认为您的作品已准备好接受审查时，请发送 a GitHub pull request .如果由于某种原因无法发送拉取请求，您还可以在Trac中使用补丁。使用此风格时，请遵循以下准则。
按返回的格式提交修补程序 git diff 命令。
将修补程序附加到 ticket tracker ，使用“附加文件”按钮。拜托 不要 将补丁放在票据描述或注释中，除非它是单行补丁。
将补丁文件命名为 .diff 扩展；这将使跟踪程序应用正确的语法突出显示，这非常有用。
无论您提交工作的方式如何，请遵循以下步骤。
确保您的代码满足我们中的要求 contribution checklist 。
选中票据上的“has patch”（有补丁）框，确保未选中“needs documentation”（需要文档）、“needs tests”（需要测试）和“patch needs improvement”（补丁需要改进）框。这使票据显示在 Development dashboard .
当补丁引入新的Django功能并做出某种设计决策时，需要进行更广泛的社区讨论。如果该方法涉及 deprecation 或引入突破性变化。
以下是从社区获得反馈的不同方法。
如果您对新功能有想法，请在 process for suggesting new features .您应该解释更改的必要性，详细介绍方法并讨论替代方案。
您可以在 Django Forum .您应该解释更改的必要性，详细介绍方法并讨论替代方案。
请在您的贡献中包含此类讨论的链接。
Django不接受实验功能。所有功能都必须遵循我们的 deprecation policy .因此，Django可能需要几个月或几年的时间才能重新设计API设计。
如果您需要用户对公共界面的反馈，最好先创建第三方包。您可以更快地在公共API上进行调试，同时还可以验证该功能的需求。
一旦该包变得稳定并且将方面纳入Django核心有明显的好处，下一步就是通过遵循 process for suggesting new features .
与Python的PEP类似，Django也 Django Enhancement Proposals 或DPP。DPP是一个设计文档，向Django社区提供信息，或描述Django的新功能或流程。它们提供了简洁的功能技术规范以及原理。BEP也是提出和收集社区对主要新功能意见的主要机制。
在考虑编写DPP之前，建议首先在 process for suggesting new features .这使得社区能够提供反馈并帮助完善提案。一旦DPP准备好， Steering Council 投票决定是否接受。
已批准并全面实施的一些BEP示例：
DEP 181: ORM Expressions <https://github.com/django/deps/blob/main/final/0181-orm-expressions.rst> _
DEP 182: Multiple Template Engines <https://github.com/django/deps/blob/main/final/0182-multiple-template-engines.rst> _
DEP 201: Simplified routing syntax <https://github.com/django/deps/blob/main/final/0201-simplified-routing-syntax.rst> _
Django中的代码可能会被废弃有几个原因：
如果某个功能已以向后不兼容的方式进行了改进或修改，则旧的功能或行为将被弃用。
有时django会包含一个python库的后端口，该库不包含在django当前支持的python版本中。当Django不再需要支持不包含库的旧版本的python时，该库将在Django中被弃用。
作为 deprecation policy 描述了Django的第一个版本，它否决了一个功能 (A.B ）应该提高 RemovedInDjangoXXWarning （其中xx是将删除该功能的django版本）调用不推荐使用的功能时。假设我们有良好的测试覆盖率，当 running the test suite 启用警告时： python -Wa runtests.py . 因此，在添加 RemovedInDjangoXXWarning 您需要消除或消除运行测试时生成的任何警告。
第一步是删除Django本身对弃用行为的任何使用。接下来，您可以使用 ignore_warnings decorator，在测试或类级别：
在特定测试中：
from django.test import ignore_warnings
from django.utils.deprecation import RemovedInDjangoXXWarning
@ignore_warnings(category=RemovedInDjangoXXWarning)
def test_foo(self): ...
对于整个测试用例：
from django.test import ignore_warnings
from django.utils.deprecation import RemovedInDjangoXXWarning
@ignore_warnings(category=RemovedInDjangoXXWarning)
class MyDeprecatedTests(unittest.TestCase): ...
您还应该为弃用警告添加测试：：
from django.utils.deprecation import RemovedInDjangoXXWarning
def test_foo_deprecation_warning(self):
msg = "Expected deprecation message"
with self.assertWarnsMessage(RemovedInDjangoXXWarning, msg) as ctx:
# invoke deprecated behavior
...
self.assertEqual(ctx.filename, __file__)
重要的是要包括一个 RemovedInDjangoXXWarning 没有警告引用的代码上方的注释，但在弃用结束时需要更改或删除。这可能包括为保留以前的行为而添加的挂钩，或者在弃用结束时不必要或未使用的独立项目。例如：：
import warnings
from django.utils.deprecation import RemovedInDjangoXXWarning
# RemovedInDjangoXXWarning.
def old_private_helper():
# Helper function that is only used in foo().
pass
def foo():
warnings.warn(
"foo() is deprecated.",
category=RemovedInDjangoXXWarning,
stacklevel=2,
)
old_private_helper()
...
最后，要对Django的文档进行以下几项更新：
如果记录了现有功能，请在文档中使用 .. deprecated:: A.B 注释。包括一个简短的描述和关于升级路径的注释（如果适用）。
将不推荐使用的行为的描述和升级路径（如果适用）添加到当前发行说明中 (docs/releases/A.B.txt ）在“A.B中已弃用的功能”标题下。
在折旧时间表中添加条目 (docs/internals/deprecation.txt ）在描述将删除哪些代码的适当版本下。
完成这些步骤后，您就完成了弃用。在每个 feature release ，所有 RemovedInDjangoXXWarning 与新版本匹配的将被删除。
有关JavaScript贡献的信息，请参阅 javascript补丁 文件。
旨在提供性能改进的补丁应该提供基准，显示补丁之前和之后的影响，并共享命令供审阅者重现。
django-asv 基准¶django-asv 监控Django代码随时间的表现。这些基准测试可以通过标记拉取请求来在拉取请求上运行 benchmark .强烈鼓励添加这些基准。
使用此清单来审查拉取请求。如果这笔贡献不会 considered trivial ，在继续审查之前，首先确保其已接受门票。
如果拉取请求符合以下所有标准并且不是您自己的，请将相应Trac票证上的“Triage Stage”设置为“Ready for Checkin”。如果您对拉取请求留下了改进意见，请根据您的审查结果在Trac票证上勾选相应的标志：“补丁需要改进”、“需要文档”和/或“需要测试”。在时间和兴趣允许的情况下，合并会对“准备签到”票据进行最终审查，并将提交更改，或者在需要进行进一步工作时将其推回“已接受”。
如果您想成为 triage & review team ，对捐款进行彻底审查是赢得信任的好方法。
正在寻找要审查的补丁？查看的“需要审查的补丁”部分 Django Development Dashboard 。
想要审查您的拉取请求吗？确保门票上的Trac标志已设置，以便门票出现在该队列中。
文档的生成是否没有任何错误？ (make html 或 make.bat html 在Windows上，从 docs 目录）？
文档是否遵循 编写文档 是吗？
有没有 spelling errors 是吗？
是否有适当的回归测试（应用修复前测试应失败）？
如果这是一个错误 qualifies for a backport 对于稳定版本的Django，有没有发布说明 docs/releases/A.B.C.txt ？只应用于主分支的错误修复不需要发布说明。
是否有测试来“练习”所有新代码？
里面有发行说明吗 docs/releases/A.B.txt 是吗？
这个功能有文档吗？ annotated appropriately 具有 .. versionadded:: A.B 或 .. versionchanged:: A.B 是吗？
见 不建议的功能 指南。
这是不是 coding style 是否符合我们的指导方针？有没有 black ， blacken-docs ， flake8 ，或 isort 错误？您可以安装 pre-commit 用于自动捕获这些错误的挂钩。
如果变更以任何方式向后不兼容，发行说明中是否有注释 (docs/releases/A.B.txt ）？
Django的测试套件通过了吗？
拉请求是否是一个单一的压缩提交，其中包含以下消息： commit message format 是吗？
你是补丁的作者和新的贡献者吗？请将您自己添加到 AUTHORS 提交并提交 Contributor License Agreement 。
Trac上有接受的车票吗？所有捐款都需要门票，除非 change is considered trivial .
5月 28, 2025