处理错误¶
Python 是一门成熟的编程语言,以稳定著称。为了维持这种声誉,开发者想知道您在 Python 中找到的所有缺陷。
有时候自己修复漏洞并将补丁提交给 Python 会更快,因为它简化了流程并且减少了参与的人力。学习如何提交补丁,请参考 contribute。
文档错误¶
如果您在本文档中发现了错误并打算帮助我们改进,请将错误提交到 tracker。如果您有建议,请一并提交。
如果您时间有限,还可以通过电子邮件将文档的错误报告发送至 docs@python.org (代码运行错误请发送至 python-list@python.org)。“docs@”是一个由志愿者运作的邮件列表;您的请求会得到关注,但可能需要一些时间才会被处理。
参见
在 Python 的错误追踪系统上的 Documentation bugs
使用 Python 的错误追踪系统¶
对于 Python 本身的错误报告应当通过 Python 错误追踪系统(https://bugs.python.org/)进行提交。该错误追踪系统提供了一个可以输入并提交相关信息给开发者的网页表单。
填写报告的第一步是确定该问题是否已经被报告过了。这样做除了可以节省开发者的时间,您也能从中了解到为解决这个问题都已经做过哪些工作;有可能这个问题已经被解决,并会在下一次发布,或者仍需要额外的信息(在这种情况下,如果可以,非常欢迎您提供这些信息!)。要做到这一点,请在错误数据库中使用页面顶部的搜索栏进行搜索。
如果您正在报告的问题并没有记录在错误追踪系统中,请返回并登录 Python 错误追踪系统。如果您没有一个错误追踪系统的账号,请选择“注册(Register)”链接,或者如果您想使用 OpenID 的话,请选择侧边栏中任何一个 OpenID 提供方的标识。您不能匿名提交一份错误报告。
如果已经登录, 那您就可以提交错误报告了。请点击侧边栏中的“新建(Create New)”链接,打开错误报告表单。
The submission form has a number of fields. For the “Title” field, enter a very short description of the problem; less than ten words is good. In the “Type” field, select the type of your problem; also select the “Component” and “Versions” to which the bug relates.
在”说明“栏,请详细描述问题,包括您预期的情况和实际的情况。请确保信息包含任何涉及的拓展模块,以及您当时所使用的硬件和软件平台(如果可能,请附上版本信息)。
每一份错误报告将被分派给一名开发者,并由这名开发者决定如何更正这个问题。每当有针对该错误的进展时,您都会收到一个更新通知。
参见
- How to Report Bugs Effectively
- 文章详细介绍了如何创建一份有用的错误报告。它描述了什么样的信息是有用的以及为什么是有用的。
- 错误书写导引
- 有关书写一份好的错误报告的信息。部分仅针对 Mozilla 项目,不过其描述了通用的恰当做法。
开始为 Python 贡献您的知识¶
除了仅仅报告您所发现的错误之外,同样欢迎您提交修复它们的补丁。您可以在 Python 开发者指引 中找到更多上手为 Python 打补丁的相关信息。如果您有任何问题,核心导师邮件列表 是一个友好的去处,在那里, 你可以寻求修复 Python事宜相关问题的答案。