处理错误

Python 是一种成熟的编程语言,以其稳定性而闻名。为了保持这种声誉,开发人员希望了解您在 Python 中发现的任何缺陷。

有时,自己修复错误并为 Python 贡献补丁会更快,因为它简化了流程,并且涉及的人员更少。了解如何贡献

文档错误

如果您在本文档中发现错误,或想提出改进建议,请在追踪器上提交错误报告。如果您有关于如何修复它的建议,也请包含在内。

您也可以在我们的文档讨论论坛上开启一个讨论主题。

如果您在文档的主题(HTML/CSS/JavaScript)中发现错误,请在python-doc-theme 错误追踪器上提交错误报告。

如果您时间不多,也可以将文档错误报告发送到docs@python.org(行为错误可以发送到python-list@python.org)。‘docs@’ 是由志愿者运营的邮件列表;您的请求将会被注意到,但可能需要一段时间才能处理。

另请参阅

文档错误

已提交到 Python 问题追踪器的文档错误列表。

问题追踪

关于在追踪器上报告改进的流程概述。

帮助编写文档

为有兴趣为 Python 文档做出贡献的个人提供的综合指南。

文档翻译

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

使用 Python 问题追踪器

针对 Python 本身的错误报告应通过 GitHub 问题追踪器提交(https://github.com/python/cpython/issues)。GitHub 问题追踪器提供了一个网页表单,允许输入相关信息并提交给开发人员。

提交报告的第一步是确定问题是否已经报告过。这样做的好处,除了节省开发人员的时间之外,还可以让您了解已经采取了哪些措施来解决问题;问题可能已经为下一个版本修复了,或者需要更多信息(在这种情况下,如果您能提供信息,欢迎您提供!)。为此,请使用页面顶部的搜索框搜索追踪器。

如果您要报告的问题不在列表中,请登录 GitHub。如果您还没有 GitHub 帐户,请使用“注册”链接创建一个新帐户。无法匿名提交错误报告。

现在您已登录,可以提交问题。点击顶栏中的“新建问题”按钮来报告新问题。

提交表单有两个字段,“标题”和“评论”。

对于“标题”字段,请输入问题的非常简短的描述;少于十个字是最好的。

在“评论”字段中,详细描述问题,包括您期望发生的事情和实际发生的事情。请务必包含是否涉及任何扩展模块,以及您使用的硬件和软件平台(包括适当的版本信息)。

每个问题报告都将由开发人员审核,他们将确定需要采取哪些措施来纠正问题。您将在每次对问题采取行动时收到更新。

另请参阅

如何有效地报告错误

文章详细介绍了如何创建有用的错误报告。这描述了哪些信息有用以及为什么有用。

错误编写指南

关于编写良好错误报告的信息。其中一些内容特定于 Mozilla 项目,但描述了通用的良好实践。

开始为 Python 做贡献

除了报告您发现的错误,您也可以提交补丁来修复它们。您可以在 Python 开发者指南 中找到有关如何开始修补 Python 的更多信息。如果您有任何问题,核心导师邮件列表 是一个友好的地方,可以获得关于修复 Python 中问题过程的任何问题的答案。