處理錯誤 (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 問題追蹤系統

Issue reports for Python itself should be submitted via the GitHub issues tracker (https://github.com/python/cpython/issues). The GitHub issues tracker offers a web form which allows pertinent information to be entered and submitted to the developers.

The first step in filing a report is to determine whether the problem has already been reported. The advantage in doing so, aside from saving the developers' time, is that you learn what has been done to fix it; it may be that the problem has already been fixed for the next release, or additional information is needed (in which case you are welcome to provide it if you can!). To do this, search the tracker using the search box at the top of the page.

If the problem you're reporting is not already in the list, log in to GitHub. If you don't already have a GitHub account, create a new account using the "Sign up" link. It is not possible to submit a bug report anonymously.

Being now logged in, you can submit an issue. Click on the "New issue" button in the top bar to report a new issue.

The submission form has two fields, "Title" and "Comment".

For the "Title" field, enter a very short description of the problem; less than ten words is good.

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

Each issue report will be reviewed by a developer who will determine what needs to be done to correct the problem. You will receive an update each time an action is taken on the issue.

也參考

如何有效地回報錯誤

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

錯誤撰寫指南

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

開始讓自己貢獻 Python

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