# 處理錯誤 (Bug)

Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽，開發者們想知道任何您在 Python 中發現的缺失。

有時候自己直接修復錯誤並且送出一個修正給 Python 會比較快，因為這樣會加速流程而且不會困擾到太多人。學習如何貢獻給 Python。

## 說明文件的錯誤

如果您在這份說明文件中發現了錯誤並想要幫助我們改進，請將錯誤報告提交到追蹤系統 (tracker)。如果您有相應的修正建議，請一併提交。（譯者註：如果是繁體中文說明文件翻譯相關的錯誤，請提交到 https://github.com/python/python-docs-zh-tw/issues。）

如果您的時間有限，也可以將說明文件的錯誤報告以電子郵件寄到 docs@python.org（程式碼執行的錯誤可以寄到 python-list@python.org）。「docs@」是一個由志工們所運行的郵寄清單；您的請求會被注意到，但可能需要一些時間才會被處理。

也參考

說明文件錯誤

  一系列已被提交至 Python 問題追蹤系統的有關說明文件的錯誤。

問題追蹤系統

  在追蹤系統上回報改進建議的過程簡介。

貢獻說明文件

  給有意成為 Python 說明文件貢獻者的綜合指南。

Documentation Translations

  A list of GitHub pages for documentation translation and their primary contacts.

## 使用 Python 問題追蹤系統

對於 Python 本身的錯誤報告，應該透過 Python 錯誤追蹤系統 (https://bugs.python.org/) 提交。這個錯誤追蹤系統提供了一個網頁表單，可以輸入並提交相關資訊給開發者。

填寫報告的第一步，是確認該問題是否已經被回報過了。這樣做的好處，除了可以節省開發者的時間，也能讓您了解目前關於該問題的處理進度；有可能已經在下一個發行版本中修正了這個問題，也有可能需要更詳細的資訊（在這種情況下，如果可以，非常歡迎您提供資訊！）。要確認是否重複回報，請使用頁面頂端的搜尋框來搜尋錯誤資料庫。

如果您想回報的問題還沒有在錯誤追蹤系統出現過，請返回並登入 Python 錯誤追蹤系統。如果您還沒有系統的帳號，請點選「註冊 (Register)」，如果您有 OpenID，也可以在側邊欄中點選其中一個 OpenID 的提供者圖示。您無法以匿名方式提交錯誤報告。

如果已經登入，那您就可以提交一個錯誤。請點選側邊欄中的「新建 (Create New)」連結，開啟錯誤回報表單。

提交的表單中有幾個欄位。（譯者註：所有欄位請皆用英文輸入。）在「標題 (Title)」欄位，輸入對該問題非常簡短的描述；最好少於十個單字。在「類型 (Type)」欄位，選擇您的問題類型；也要選擇與錯誤相關的「Component（組件）」和「Versions（版本）」。

在「Comment（說明）」欄位，請詳細描述該問題，包括您預期發生的情況和實際發生的情況。請確定說明中包含了涉及到的任何擴充模組，以及您當時所使用的硬體和軟體平台（視情況而定，可以附上版本資訊）。

每一份錯誤報告會被分派給一位開發者，並由他決定要做出什麼變更來修正這個問題。每當該錯誤有修正動作時，您會收到更新回報。

也參考

如何有效地回報錯誤

  這篇文章詳細說明如何建立一份有用的錯誤報告。它描述了什麼樣的資訊是有用的，以及這些資訊為什麼有用。

錯誤撰寫指南

  撰寫一份優良錯誤報告的相關資訊。部分的文章內容是針對 Mozilla 專案，但它也描述了通用的好習慣。

## 開始讓自己貢獻 Python

除了只是回報您所發現的錯誤之外，同樣也歡迎您提交修正它們的修補程式 (patch)。您可以在 Python 開發者指南中找到如何開始修補 Python 的更多資訊。如果您有任何問題，核心導師郵寄清單是一個友善的地方，您可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。