處理錯誤¶
Python 是一種成熟的程式語言,以其穩定性而聞名。為了維護這種聲譽,開發人員希望瞭解您在 Python 中發現的任何缺陷。
有時,自己修復錯誤併為 Python 貢獻補丁會更快,因為這可以簡化流程並減少參與人員。瞭解如何貢獻。
文件錯誤¶
如果您在本文件中發現錯誤或想提出改進建議,請在跟蹤器上提交錯誤報告。如果您有關於如何修復它的建議,也請一併提供。
您還可以在我們的文件討論論壇上開啟一個討論主題。
如果您在文件的主題(HTML / CSS / JavaScript)中發現錯誤,請在python-doc-theme 錯誤跟蹤器上提交錯誤報告。
如果您時間緊迫,也可以將文件錯誤報告透過電子郵件傳送至docs@python.org(行為錯誤可以傳送至python-list@python.org)。'docs@' 是由志願者執行的郵件列表;您的請求將會被注意到,儘管可能需要一段時間才能處理。
使用 Python 問題跟蹤器¶
Python 本身的問題報告應透過 GitHub 問題跟蹤器提交 (https://github.com/python/cpython/issues)。GitHub 問題跟蹤器提供了一個 Web 表單,允許輸入相關資訊並將其提交給開發人員。
提交報告的第一步是確定該問題是否已被報告。這樣做的好處是,除了節省開發人員的時間外,您還可以瞭解已採取的修復措施;問題可能已在下一個版本中修復,或者需要其他資訊(在這種情況下,如果您可以提供,歡迎提供!)。為此,請使用頁面頂部的搜尋框搜尋跟蹤器。
如果您要報告的問題不在列表中,請登入 GitHub。如果您還沒有 GitHub 帳戶,請使用“Sign up”連結建立一個新帳戶。不能匿名提交錯誤報告。
現在登入後,您可以提交問題。單擊頂部欄中的“New issue”按鈕以報告新問題。
提交表單有兩個欄位,“標題”和“評論”。
在“標題”欄位中,輸入問題的非常簡短的描述;少於十個字為佳。
在“評論”欄位中,詳細描述問題,包括您期望發生的事情和實際發生的事情。請務必包括是否涉及任何擴充套件模組,以及您使用的硬體和軟體平臺(包括適當的版本資訊)。
每個問題報告都將由開發人員審查,他們將確定需要採取哪些措施來糾正問題。每次對問題採取行動時,您都會收到更新。
開始為 Python 做出貢獻¶
除了報告您發現的錯誤外,您還可以提交補丁來修復它們。您可以在Python 開發人員指南中找到有關如何開始修補 Python 的更多資訊。如果您有任何疑問,core-mentorship 郵件列表是一個友好的地方,可以獲得關於修復 Python 中問題的過程的任何和所有問題的答案。