處理錯誤 (Bug)¶
Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽,開發者們想知道任何你在 Python 中發現的缺失。
It can be sometimes faster to fix bugs yourself and contribute patches toPython as it streamlines the process and involves fewer people. Learn how tocontribute.
說明文件的錯誤¶
如果你在這份說明文件中發現了錯誤並想要提出改進方案,請將錯誤報告提交到錯誤追蹤系統 (issue tracker)。如果你有相應的修正建議,請一併提交。(譯者註:如果是繁體中文說明文件翻譯相關的錯誤,請提交到https://github.com/python/python-docs-zh-tw/issues。)
如果錯誤或建議的改進涉及此文件的翻譯,請將報告提交到翻譯存儲庫。
你也可以在我們的說明文件 Discourse 討論區中新增一個討論事項。
如果你發現文件主題 (HTML / CSS / JavaScript) 中存在錯誤,請在python-doc-theme 問題追蹤系統上提交錯誤報告。
使用 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 修正錯誤的過程中,所有問題的答案。