重要
请报告安全问题 only 发送至security@djangoproject.com。这是一个私人列表,只对长期、高度信任的Django开发人员开放,其档案不公开。有关详细信息,请参阅 our security policies .
在报告错误之前 ticket tracker 考虑以下几点:
检查是否有人尚未提交错误报告 searching 或跑步 custom queries 在门票跟踪器中。
不要使用票务系统询问支持问题。使用 Django Forum 或 Django Discord server 的想要进行
在没有达成共识的情况下,不要重新讨论已标记为“wontFix”的问题 Django Forum .
不要使用票证跟踪器进行冗长的讨论,因为它们很可能会丢失。如果某张票有争议,请将讨论移至 Django Forum .
写得好的错误报告是 难以置信地 乐于助人。但是,在使用任何bug跟踪系统时都会有一定的开销,因此感谢您帮助我们尽可能地保持跟踪系统的实用性。特别地:
Do 阅读 FAQ 看看你的问题是否是一个众所周知的问题。
Do ask on Django Forum or the Django Discord server first if you're not sure if what you're seeing is a bug.
Do 编写完整、可重复、特定的错误报告。您必须包含对问题的清晰、简洁的描述,以及一组复制它的说明。尽可能多地添加调试信息:代码片段、测试案例、异常回溯、屏幕截图等。一个漂亮的小测试案例是报告错误的最佳方式,因为它为我们提供了一种快速确认错误的有用方法。
Don't 员额到 Django Forum 只是宣布您已提交错误报告。所有门票都被邮寄到另一个名单上,django-updates,由开发人员和感兴趣的社区成员跟踪;我们会在归档时查看它们。
要在创建票据后了解其生命周期,请参阅 试用票 .
如果你的bug影响了任何视觉上的东西,还有一些额外的指导原则要遵循:
在您的票证中包括屏幕截图,这些截图相当于最小测试用例的视觉效果。炫耀问题,而不是你对浏览器所做的疯狂定制。
如果使用静止图像很难显示问题,请考虑捕获 简明的 尖叫声如果软件允许,只捕获屏幕的相关区域。
如果您提供的补丁可以改变Django的用户界面的外观或行为,那么您 must 附着在前面 and 截图/截图之后。缺少这些的机票很难让分拣人员快速评估。
截图并不能免除你其他优秀的报告实践。确保包含URL、代码片段和关于如何重现屏幕截图中可见行为的分步说明。
确保在票据上设置ui/ux标志,以便相关方可以找到您的票据。
我们一直在努力使django变得更好,您的功能请求是其中的一个关键部分。以下是一些关于如何最有效地提出请求的提示:
评估功能创意是否需要改变Django的核心。如果您的想法可以开发为独立的应用程序或模块-例如,您想要支持另一个数据库引擎-我们可能会建议您独立开发它。然后,如果您的项目获得了足够的社区支持,我们可能会考虑将其纳入Django。
在 new feature ideas GitHub项目(不在门票跟踪器中)通过在 Idea 柱这是社区和 Steering Council 评估Django生态系统的新想法。这一步对于大型或复杂的提案尤其重要。我们更愿意在任何开发开始之前讨论Django核心的任何重大变化。在某些情况下,某个功能可能更适合作为第三方包,其中它可以独立于Django的发布周期而发展。
清楚而简明地描述缺少的特性是什么,以及您希望如何实现它。如果可能,包括示例代码(非功能正常)。
解释 why 您会喜欢该功能。解释一个最小用例将帮助其他人了解它适合哪里,以及是否已经有其他方法可以实现同样的事情。
参见: 记录新功能 .
性能回归报告或建议的性能优化应为票据筛选器提供重现的基准和命令。
看到 django-asv 基准 了解Django现有基准的更多详细信息。
只要有可能,我们的目标是达成粗略的共识。Emoji反应用于解决 new feature ideas GitHub项目用于跟踪社区反馈。每个反应具有以下含义:
警告:我支持此功能并会使用它
警告:我反对此功能或相信它会给我或Django带来问题
警告:我对这个功能没有强烈的看法
显示:此功能似乎是一个简单且有益的添加
的 Steering Council 将定期审查项目中的想法,让那些获得社区支持的人经历以下阶段:
想法
批准-想法细化-团队创建
进行中
工作解决方案-审查-反馈
需要维护者(仅限Django)
做
偶尔,Django论坛上可能会讨论专题创意或Django的方向。这些讨论可能包括非正式投票,它遵循由Apache发明并在Python本身上使用的投票风格,其中投票以+1、+0、-0或-1的形式给出。粗略翻译,这些选票意味着:
+1:“我喜欢这个想法,并且我坚定地致力于它。”
+0:“我觉得没问题。”
-0:“我不兴奋,但我不会挡道。”
-1:“我强烈反对,如果看到这个想法变成现实,我会非常不高兴。”
虽然这些投票是非正式的,但他们将被非常认真地对待。在适当的投票期之后,如果达成明显的共识,我们将跟踪投票结果。
5月 28, 2025