處理錯誤

Python 是一種成熟的程式語言,以其穩定性而聞名。為了維護這種聲譽,開發人員希望瞭解您在 Python 中發現的任何缺陷。

有時,自己修復錯誤併為 Python 貢獻補丁會更快,因為這可以簡化流程並減少參與人員。瞭解如何貢獻

文件錯誤

如果您在本文件中發現錯誤或想提出改進建議,請在跟蹤器上提交錯誤報告。如果您有關於如何修復它的建議,也請一併提供。

您還可以在我們的文件討論論壇上開啟一個討論主題。

如果您在文件的主題(HTML / CSS / JavaScript)中發現錯誤,請在python-doc-theme 錯誤跟蹤器上提交錯誤報告。

如果您時間緊迫,也可以將文件錯誤報告透過電子郵件傳送至docs@python.org(行為錯誤可以傳送至python-list@python.org)。'docs@' 是由志願者執行的郵件列表;您的請求將會被注意到,儘管可能需要一段時間才能處理。

另請參閱

文件錯誤

已提交到 Python 問題跟蹤器的文件錯誤列表。

問題跟蹤

概述在跟蹤器上報告改進所涉及的過程。

幫助改進文件

為有興趣為 Python 文件做出貢獻的個人提供的綜合指南。

文件翻譯

文件翻譯的 GitHub 頁面及其主要聯絡人的列表。

使用 Python 問題跟蹤器

Python 本身的問題報告應透過 GitHub 問題跟蹤器提交 (https://github.com/python/cpython/issues)。GitHub 問題跟蹤器提供了一個 Web 表單,允許輸入相關資訊並將其提交給開發人員。

提交報告的第一步是確定該問題是否已被報告。這樣做的好處是,除了節省開發人員的時間外,您還可以瞭解已採取的修復措施;問題可能已在下一個版本中修復,或者需要其他資訊(在這種情況下,如果您可以提供,歡迎提供!)。為此,請使用頁面頂部的搜尋框搜尋跟蹤器。

如果您要報告的問題不在列表中,請登入 GitHub。如果您還沒有 GitHub 帳戶,請使用“Sign up”連結建立一個新帳戶。不能匿名提交錯誤報告。

現在登入後,您可以提交問題。單擊頂部欄中的“New issue”按鈕以報告新問題。

提交表單有兩個欄位,“標題”和“評論”。

在“標題”欄位中,輸入問題的非常簡短的描述;少於十個字為佳。

在“評論”欄位中,詳細描述問題,包括您期望發生的事情和實際發生的事情。請務必包括是否涉及任何擴充套件模組,以及您使用的硬體和軟體平臺(包括適當的版本資訊)。

每個問題報告都將由開發人員審查,他們將確定需要採取哪些措施來糾正問題。每次對問題採取行動時,您都會收到更新。

另請參閱

如何有效報告錯誤

詳細介紹如何建立有用的錯誤報告的文章。這描述了哪些型別的資訊有用以及為什麼有用。

錯誤編寫指南

關於編寫好的錯誤報告的資訊。其中一些是針對 Mozilla 專案的,但描述了一般的良好實踐。

開始為 Python 做出貢獻

除了報告您發現的錯誤外,您還可以提交補丁來修復它們。您可以在Python 開發人員指南中找到有關如何開始修補 Python 的更多資訊。如果您有任何疑問,core-mentorship 郵件列表是一個友好的地方,可以獲得關於修復 Python 中問題的過程的任何和所有問題的答案。