處理錯誤 (Bug)

Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽,開發者們想知道任何您在 Python 中發現的缺失。

有時候自己直接修復錯誤並且送出一個修正給 Python 會比較快,因為這樣會加速流程而且不會困擾到太多人。學習如何貢獻給 Python

說明文件的錯誤

如果您在這份說明文件中發現了錯誤並想要幫助我們改進,請將錯誤報告提交到追蹤系統 (tracker)。如果您有相應的修正建議,請一併提交。(譯者註:如果是繁體中文說明文件翻譯相關的錯誤,請提交到 https://github.com/python/python-docs-zh-tw/issues。)

如果您的時間有限,也可以將說明文件的錯誤報告以電子郵件寄到 docs@python.org(程式碼執行的錯誤可以寄到 python-list@python.org)。「docs@」是一個由志工們所運行的郵寄清單;您的請求會被注意到,但可能需要一些時間才會被處理。

也參考

說明文件錯誤

一系列已被提交至 Python 問題追蹤系統的有關說明文件的錯誤。

問題追蹤系統

在追蹤系統上回報改進建議的過程簡介。

貢獻說明文件

給有意成為 Python 說明文件貢獻者的綜合指南。

文档翻译

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

使用 Python 問題追蹤系統

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

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

如果你要报告的问题未出现在列表中,请登录 GitHub 报告。 如果你还没有 GitHub 账号,请使用 "Sign up" 链接新建一个账号。 错误报告是不可能自动被提交的。

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

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

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

在「Comment(說明)」欄位,請詳細描述該問題,包括您預期發生的情況和實際發生的情況。請確定說明中包含了涉及到的任何擴充模組,以及您當時所使用的硬體和軟體平台(視情況而定,可以附上版本資訊)。

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

也參考

如何有效地回報錯誤

這篇文章詳細說明如何建立一份有用的錯誤報告。它描述了什麼樣的資訊是有用的,以及這些資訊為什麼有用。

錯誤撰寫指南

撰寫一份優良錯誤報告的相關資訊。部分的文章內容是針對 Mozilla 專案,但它也描述了通用的好習慣。

開始讓自己貢獻 Python

除了只是回報您所發現的錯誤之外,同樣也歡迎您提交修正它們的修補程式 (patch)。您可以在 Python 開發者指南中找到如何開始修補 Python 的更多資訊。如果您有任何問題,核心導師郵寄清單是一個友善的地方,您可以在那裡得到,關於 Python 修正錯誤的過程中,所有問題的答案。