處理錯誤 (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 問題追蹤系統 (https://github.com/python/cpython/issues) 提交。這個 GitHub 問題追蹤系統提供了一個網頁表單,可以輸入並提交相關資訊給開發者。
填寫報告的第一步,是確認該問題是否已經被回報過了。這樣做的好處,除了可以節省開發者的時間,也能讓您了解目前關於該問題的處理進度;有可能已經在下一個發行版本中修正了這個問題,也有可能需要更詳細的資訊(在這種情況下,如果可以,非常歡迎您提供資訊!)。要確認是否重複回報,請使用頁面頂端的搜尋框來搜尋追蹤系統。
如果您想回報的問題還沒有在問題列表出現過,請登入 GitHub。如果您還沒有 GitHub 帳戶,請點選「Sign up」連結來建立一個新的帳戶。您無法以匿名方式提交錯誤報告。
如果已經登入,那您就可以提交問題了。請點選列表頂端區域的「New issue」按鈕,來回報一個新的問題。
提交的表單中有兩個欄位,「Title」及「Comment」。
对于 "Title" 字段,请输入对问题的 非常 简短的描述;最好是少于十个单词。
在「Comment」欄位,請詳細描述該問題,包括您預期發生的情況和實際發生的情況。請確定說明中包含了涉及到的任何擴充模組,以及您當時所使用的硬體和軟體平台(視情況而定,可以附上版本資訊)。
每一份問題報告都會被一位開發人員查核,並由他決定要做出什麼變更來修正這個問題。每當該問題有修正動作時,您會收到更新回報。
開始讓自己貢獻 Python¶
除了只是回報您所發現的錯誤之外,同樣也歡迎您提交修正它們的修補程式 (patch)。您可以在 Python 開發者指南中找到如何開始修補 Python 的更多資訊。如果您有任何問題,核心導師郵寄清單是一個友善的地方,您可以在那裡得到,關於 Python 修正錯誤的過程中,所有問題的答案。