# 处理 Bug

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

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

## 文档错误

如果您在本文档中发现错误或想要提出改进建议，请在 问题追踪器 上提交错误报告。如果您有修复建议，也请一并提供。

如果程序缺陷或建议的改进涉及此文档的翻译，请将报告提交到 文档翻译仓库。

你还可以在我们的 文档论坛 上发起一个讨论。

如果你在文档的主题（HTML / CSS / JavaScript）中发现错误，请在 python-doc-theme 问题追踪器 上提交错误报告。

参见

Documentation bugs

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

问题跟踪

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

改进文档

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

Documentation Translations

  A list of GitHub pages for documentation translation and their coordination teams.

## 使用 Python 的问题追踪系统

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

第一步是确定问题是否已经被报告了。 这样做的好处除了可以节省开发者的时间，还可以让你了解该问题是如何解决的；有可能该问题已在下一发布版中被修复，或者还需要额外的信息（在此情况下非常欢迎你来提供信息！）。 要确定这一点，请使用页面顶部的搜索框来搜索问题追踪系统。

如果你要报告的问题未出现在列表中，请登录 GitHub 报告。如果你还没有 GitHub 账号，请使用 "Sign up" 链接新建一个账号。 错误报告无法匿名提交。

当你登录之后，就可以提交问题了。请点击顶端栏的 "New issue" 按钮来报告新问题。

提交表单有两个字段，"Title" 和 "Comment"。

对于 "Title" 字段，请输入对问题的 非常 简短的描述；最好是少于十个单词。

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

每个问题报告将由一位开发者进行审查并决定要以何种方式来修正该问题。每当对该问题有新的处理措施时你都会收到更新的消息。

参见

如何有效地报告错误

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

Bug Writing Guidelines

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

## 开始亲自为 Python 做贡献

除了仅仅报告您所发现的错误之外，同样欢迎您提交修复它们的补丁。您可以在 Python Developer's Guide 中找到更多为 Python 打补丁的信息。如果您有任何问题，core-mentorship mailing list 是一个友好的去处，在那里， 你可以寻求修复 Python 相关问题的答案。