处理错误

Python 是一门成熟的编程语言,以稳定著称。为维持其美誉,开发者希望获悉所有您在 Python 中发现的缺陷。

有时候自己修复漏洞并将补丁提交给 Python 能更快地解决问题,因为它简化了流程并且减少了参与的人力。 请参阅如何 提交补丁

文档 Bug

如果您在本文档中发现了错误并打算帮助我们改进,请将错误提交到 追踪系统。 如果您有相应的修正建议,请一并提交。 (译者注:如果是中文文档翻译相关的错误,请务必提交到 https://github.com/python/python-docs-zh-cn/issues。如果将翻译问题反馈到了其他地方,可能会因为语言不通而不能及时处理。)

You can also open a discussion item on our Documentation Discourse forum.

如果您时间有限,还可以通过电子邮件将文档的错误报告发送至 docs@python.org(代码运行错误请发送至 python-list@python.org)。“docs@”是一个由志愿者运作的邮件列表;您的请求会得到关注,但可能需要一些时间才会被处理。

参见

Documentation bugs

已提交给 Python 问题追踪系统的文档错误列表。

问题跟踪

在追踪系统上参与问题改进的过程概述。

改进文档

给有兴趣为 Python 文档做出贡献的人。

文档翻译

文档翻译的 GitHub 页面及其主要联系人的列表

使用 Python 的问题追踪系统

Issue reports for Python itself should be submitted via the GitHub issues tracker (https://github.com/python/cpython/issues). The GitHub issues tracker offers a web form which allows pertinent information to be entered and submitted to the developers.

The first step in filing a report is to determine whether the problem has already been reported. The advantage in doing so, aside from saving the developers' time, is that you learn what has been done to fix it; it may be that the problem has already been fixed for the next release, or additional information is needed (in which case you are welcome to provide it if you can!). To do this, search the tracker using the search box at the top of the page.

If the problem you're reporting is not already in the list, log in to GitHub. If you don't already have a GitHub account, create a new account using the "Sign up" link. It is not possible to submit a bug report anonymously.

Being now logged in, you can submit an issue. Click on the "New issue" button in the top bar to report a new issue.

The submission form has two fields, "Title" and "Comment".

For the "Title" field, enter a very short description of the problem; fewer than ten words is good.

在“说明(Comment)”栏,请详细描述问题,包括您预期的情况和实际的情况。请确保包含任何涉及的拓展模块,以及您当时所使用的硬件和软件平台(如果可能,请附上版本信息)。

Each issue report will be reviewed by a developer who will determine what needs to be done to correct the problem. You will receive an update each time an action is taken on the issue.

参见

如何有效地报告错误

该文章详细介绍了如何创建一份有用的错误报告。它描述了什么样的信息是有用的,以及为什么是有用的。

Bug Writing Guidelines

关于写一份好的错误报告。部分仅针对 Mozilla 项目,不过其描述了通用的恰当做法。

开始为 Python 贡献您的知识

除了仅仅报告您所发现的错误之外,同样欢迎您提交修复它们的补丁。您可以在 Python 开发者指引 中找到更多为 Python 打补丁的信息。如果您有任何问题,核心导师邮件列表 是一个友好的去处,在那里, 你可以寻求修复 Python 相关问题的答案。