问题跟踪器

使用问题跟踪器

如果您认为您在 Python 中发现了错误，您可以向 问题跟踪器 报告。 问题跟踪器 现在托管在 GitHub 上，与代码库和拉取请求并列。文档错误也可以在那里报告。

如果您想提交有关此开发指南的问题，请在 devguide 仓库 中提交。

注意

在将问题跟踪器移至 GitHub 之前，Python 曾经使用一个专门的 Roundup 实例作为其问题跟踪器。该 旧错误跟踪器 托管在域名 bugs.python.org 下（有时简称为 bpo）。出于历史目的，该域名上提供了只读版本。所有 bpo 数据已迁移到 GitHub 上当前的 问题跟踪器。

如果您熟悉 bpo 并且想了解有关 GitHub 问题的更多信息，请阅读此页面，以及 对问题进行分类 页面，因为它们提供了良好的入门材料。还有一个 GitHub 问题，供 BPO 用户使用 文档来回答一些更常见的问题。

检查错误是否已存在

在提交问题报告之前的第一步是查看问题是否已报告。检查问题是否是现有问题将

  • 帮助您查看问题是否已解决或已针对下一个版本修复

  • 为您和开发人员节省时间

  • 帮助您了解修复问题需要做什么

  • 确定是否需要其他信息，例如如何复制问题

要查看问题是否已存在，请使用问题页面上错误列表上方的搜索框搜索错误数据库。GitHub 上还提供了一个基于表单的 高级搜索 查询构建器，以帮助创建您需要的文本查询。

报告问题

如果您报告的问题尚未在 问题跟踪器 中，您可以使用错误列表上方的搜索框右侧的绿色“新建问题”按钮进行报告。如果您尚未登录 GitHub，它现在会要求您登录。

首先，您需要选择要报告的问题类型。可用的选项是

  • 错误报告：现有功能未按预期工作；

  • 文档：缺少、无效或误导性文档；

  • 增强：为 Python 建议一项新功能；

  • 性能：某些内容应工作得更快；

  • 安全：存在特定类型的弱点，可通过漏洞点进行利用；

  • 测试：CPython 的回归测试套件出现问题；

  • 讨论：您希望了解有关 Python 的更多信息，讨论对未来 Python 版本可能进行的更改的想法，跟踪核心开发讨论，或加入特定的特殊兴趣小组。

根据您的选择，将显示一个专门的表单模板。特别是，您会注意到最后一个按钮实际上会带您到 Python Discourse (discuss.python.org)，那里有许多与 Python 相关的讨论。

提交表单只有两个字段需要填写

  • 在 标题 字段中，输入问题的非常简短描述；少于十个单词即可；

  • 在 编写 字段中，使用该字段中为您放入的模板中的提示详细描述问题。务必包括您期望发生的情况、实际发生的情况以及如何复制问题。务必包括是否涉及任何扩展模块，以及您使用的硬件和软件平台（包括版本信息，视情况而定）。特别是，您使用的是哪个版本的 Python。

如果您认为应该引起他们的注意，则可以在评论中使用 @username 标记某人。使用 专家索引 来了解谁希望被标记或分配到特定领域。

还有许多其他字段，如 受让人、标签和 项目。这些字段由分类人员和核心开发人员填写，并在 对问题进行分类 页面中进行了介绍。作为 Python 用户报告问题时，您无需担心这些问题。

关注问题

如果您想订阅问题，请单击侧边栏中的 🔔 订阅 按钮。同样，如果您被其他人标记但认为此问题不适合您，请单击侧边栏中的 🔕 退订 按钮。请注意，您会自动订阅您创建的问题。

跟踪依赖项和重复项

可以使用 清单 来跟踪依赖项，或者在元问题的情况下，链接到其他相关问题。

通过在评论中编写 Duplicate of #NNN，您可以 将问题和 PR 标记为重复项。

与问题跟踪器上的解决方案存在分歧

作为人类，我们偶尔会有不同的意见。首先，请尊重解决方案的用心、思考和志愿者时间。

考虑到这一点，请花一些时间考虑与问题解决方案相关的任何评论。经过思考，解决方案步骤可能比您最初想象的更合理。

如果您仍然认为解决方案不正确，那么请在 核心开发讨论类别 中提出一个深思熟虑的问题。在核心开发人员达成共识后，进一步的争论和不尊重的回应不太可能赢得任何支持者。

提醒一下，由核心开发人员关闭的问题已经经过仔细考虑。请勿重新打开已关闭的问题。问题可以关闭，原因是 complete 或 not planned。

另请参阅

Python 问题跟踪器

报告 Python 问题的位置。