处理 Bug

Python 是一门成熟的编程语言,以其稳定性而著称。为了保持这一声誉,开发者们希望了解您在 Python 中发现的任何不足之处。

有时候,自己修复 bug 并为 Python 贡献补丁会更快,因为这可以简化流程并减少参与人员。了解如何贡献

文档 Bug

如果您在本文档中发现 bug 或希望提出改进建议,请在问题追踪器上提交 bug 报告。如果您有修复建议,也请一并附上。

您也可以在我们的文档 Discourse 论坛上发起讨论。

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

参见

文档 Bug

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

问题追踪

在追踪器上报告改进建议的流程概述。

帮助完善文档

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

文档翻译

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

使用 Python 问题追踪器

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

提交报告的第一步是确定该问题是否已被报告。这样做的好处除了节省开发者的时间外,您还可以了解到为修复该问题已做了哪些工作;可能该问题已在下一版本中修复,或者需要更多信息(在这种情况下,如果您能提供,我们将非常欢迎!)。要做到这一点,请使用页面顶部的搜索框在追踪器中进行搜索。

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

登录后,您就可以提交问题了。点击顶部栏中的“New issue”按钮来报告新问题。

提交表单有两个字段:“Title”和“Comment”。

对于“Title”字段,请输入对问题的*非常*简短的描述;少于十个词为佳。

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

每个问题报告都将由一名开发者审查,以确定需要采取何种措施来纠正问题。每当问题有任何进展时,您都会收到更新。

参见

如何有效地报告 Bug

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

Bug 编写指南

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

开始为 Python 做贡献

除了报告您发现的 bug,我们也欢迎您提交修复这些 bug 的补丁。您可以在《Python 开发者指南》中找到更多关于如何开始为 Python 贡献补丁的信息。如果您有任何问题,核心指导邮件列表是一个友好的地方,可以解答有关修复 Python 问题的任何疑问。