處理 Bug¶
Python 是一門成熟的程式語言,以其穩定性而著稱。為了保持這一聲譽,開發者們希望瞭解您在 Python 中發現的任何不足之處。
有時候,自己修復 bug 併為 Python 貢獻補丁會更快,因為這可以簡化流程並減少參與人員。瞭解如何貢獻。
文件 Bug¶
如果您在本文件中發現 bug 或希望提出改進建議,請在問題追蹤器上提交 bug 報告。如果您有修復建議,也請一併附上。
您也可以在我們的文件 Discourse 論壇上發起討論。
如果您發現文件主題(HTML / CSS / JavaScript)存在 bug,請在 python-doc-theme 問題追蹤器上提交 bug 報告。
使用 Python 問題追蹤器¶
針對 Python 本身的問題報告應透過 GitHub 問題追蹤器提交(https://github.com/python/cpython/issues)。GitHub 問題追蹤器提供了一個網頁表單,可用於輸入相關資訊並提交給開發者。
提交報告的第一步是確定該問題是否已被報告。這樣做的好處除了節省開發者的時間外,您還可以瞭解到為修復該問題已做了哪些工作;可能該問題已在下一版本中修復,或者需要更多資訊(在這種情況下,如果您能提供,我們將非常歡迎!)。要做到這一點,請使用頁面頂部的搜尋框在追蹤器中進行搜尋。
如果您要報告的問題不在列表中,請登入 GitHub。如果您還沒有 GitHub 帳戶,請使用“Sign up”連結建立一個新帳戶。無法匿名提交 bug 報告。
登入後,您就可以提交問題了。點選頂部欄中的“New issue”按鈕來報告新問題。
提交表單有兩個欄位:“Title”和“Comment”。
對於“Title”欄位,請輸入對問題的*非常*簡短的描述;少於十個詞為佳。
在“Comment”欄位中,請詳細描述問題,包括您期望發生的情況和實際發生的情況。請務必說明是否涉及任何擴充套件模組,以及您使用的硬體和軟體平臺(包括相應的版本資訊)。
每個問題報告都將由一名開發者審查,以確定需要採取何種措施來糾正問題。每當問題有任何進展時,您都會收到更新。
參見
- 如何有效地報告 Bug
這篇文章詳細介紹如何建立有用的 bug 報告。它描述了哪些資訊是有用的以及為什麼有用。
- Bug 編寫指南
關於如何編寫好的 bug 報告的資訊。其中一些內容特定於 Mozilla 專案,但也描述了通用的良好實踐。
開始為 Python 做貢獻¶
除了報告您發現的 bug,我們也歡迎您提交修復這些 bug 的補丁。您可以在《Python 開發者指南》中找到更多關於如何開始為 Python 貢獻補丁的資訊。如果您有任何問題,核心指導郵件列表是一個友好的地方,可以解答有關修復 Python 問題的任何疑問。