解決 Bug?

Python 是一門以穩定著稱的編程語言。為了保持它的穩定性,開發者們想了解您在 Python 中發現的任何缺陷。

有時候自己修復漏洞并將補丁提交給 Python 能更快地解決問題,因為它簡化了流程并且減少了參與的人力。 請參閱如何 提交補丁

文檔 Bug?

如果您在本文檔中發現了錯誤并打算幫助我們改進,請將錯誤提交到 追蹤系統。 如果您有相應的修正建議,請一并提交。 (譯者注:如果是中文文檔翻譯相關的錯誤,請務必提交到 。如果將翻譯問題反饋到了其他地方,可能會因為語言不通而不能及時處理。)

如果您時間有限,還可以通過電子郵件將文檔的錯誤報告發送至 docs@python.org (代碼運行錯誤請發送至 python-list@python.org)。“docs@”是一個由志愿者運作的郵件列表;您的請求會得到關注,但可能需要一些時間才會被處理。

參見

在 Python 的錯誤追蹤系統上的

使用 Python 的問題追蹤系統?

對于 Python 本身的錯誤報告應當通過 Python 錯誤追蹤系統()進行提交。該錯誤追蹤系統提供了一個可以輸入并提交相關信息給開發者的網頁表單。

填寫報告的第一步是確認是否有重復的報告。這樣做除了可以節省開發者的時間,也能讓您從中為了解決這個問題我們做出了怎樣的努力;我們有可能我們已經在下個版本中修復了這個問題,也有可能需要更詳細的信息來搞定它(在這種情況下,如果可以,非常歡迎您提供這些信息!)。要查找重復的報告,請使用錯誤數據庫頁面頂部的搜索欄進行搜索。

如果您正在報告的問題并沒有記錄在錯誤追蹤系統中,請返回并登錄 Python 錯誤追蹤系統。如果您沒有一個錯誤追蹤系統的賬號,請選擇“注冊(Register)”鏈接,或者如果您想使用 OpenID 的話,請選擇側邊欄中任何一個 OpenID 提供方的標識。您不能匿名提交一份錯誤報告。

如果已經登錄, 那您就可以提交錯誤報告了。請點擊側邊欄中的“新建(Create New)”鏈接,打開錯誤報告表單。

表單中有幾個空欄。請在 “標題” 欄填入一個對問題的非常簡短的描述;一個好的描述應當少于十個字。在 “類型” 欄,選擇您的問題的類型;同樣地,選擇bug相對應的 “組件” 和 “版本” 。

在”說明“欄,請詳細描述問題,包括您預期的情況和實際的情況。請確保信息包含任何涉及的拓展模塊,以及您當時所使用的硬件和軟件平臺(如果可能,請附上版本信息)。

每一份錯誤報告將被分派給一名開發者,并由這名開發者決定如何更正這個問題。每當有針對該錯誤的進展時,您都會收到一個更新通知。

參見

文章詳細描述了如何創建一份有用的錯誤報告。同時描述了什么樣的信息是有用的以及為什么是有用的。

有關書寫一份好的錯誤報告的信息。部分僅針對 Mozilla 項目,不過其描述了通用的恰當做法。

開始為 Python 貢獻您的知識?

除了僅僅報告您所發現的錯誤之外,同樣歡迎您提交修復它們的補丁。您可以在 中找到更多上手為 Python 打補丁的相關信息。如果您有任何問題, 是一個友好的去處,在那里, 你可以尋求修復 Python事宜相關問題的答案。