处理错误¶
Python 是一种成熟的编程语言,以其稳定性而闻名。为了维护这种声誉,开发人员希望了解您在 Python 中发现的任何缺陷。
有时,自己修复错误并为 Python 贡献补丁会更快,因为这可以简化流程并减少参与人员。了解如何贡献。
文档错误¶
如果您在本文档中发现错误或想提出改进建议,请在跟踪器上提交错误报告。如果您有关于如何修复它的建议,也请一并提供。
您还可以在我们的文档讨论论坛上开启一个讨论主题。
如果您在文档的主题(HTML / CSS / JavaScript)中发现错误,请在python-doc-theme 错误跟踪器上提交错误报告。
如果您时间紧迫,也可以将文档错误报告通过电子邮件发送至docs@python.org(行为错误可以发送至python-list@python.org)。'docs@' 是由志愿者运行的邮件列表;您的请求将会被注意到,尽管可能需要一段时间才能处理。
使用 Python 问题跟踪器¶
Python 本身的问题报告应通过 GitHub 问题跟踪器提交 (https://github.com/python/cpython/issues)。GitHub 问题跟踪器提供了一个 Web 表单,允许输入相关信息并将其提交给开发人员。
提交报告的第一步是确定该问题是否已被报告。这样做的好处是,除了节省开发人员的时间外,您还可以了解已采取的修复措施;问题可能已在下一个版本中修复,或者需要其他信息(在这种情况下,如果您可以提供,欢迎提供!)。为此,请使用页面顶部的搜索框搜索跟踪器。
如果您要报告的问题不在列表中,请登录 GitHub。如果您还没有 GitHub 帐户,请使用“Sign up”链接创建一个新帐户。不能匿名提交错误报告。
现在登录后,您可以提交问题。单击顶部栏中的“New issue”按钮以报告新问题。
提交表单有两个字段,“标题”和“评论”。
在“标题”字段中,输入问题的非常简短的描述;少于十个字为佳。
在“评论”字段中,详细描述问题,包括您期望发生的事情和实际发生的事情。请务必包括是否涉及任何扩展模块,以及您使用的硬件和软件平台(包括适当的版本信息)。
每个问题报告都将由开发人员审查,他们将确定需要采取哪些措施来纠正问题。每次对问题采取行动时,您都会收到更新。
开始为 Python 做出贡献¶
除了报告您发现的错误外,您还可以提交补丁来修复它们。您可以在Python 开发人员指南中找到有关如何开始修补 Python 的更多信息。如果您有任何疑问,core-mentorship 邮件列表是一个友好的地方,可以获得关于修复 Python 中问题的过程的任何和所有问题的答案。