在 VS Code 中設定 Python 格式

格式化使人類更容易閱讀原始碼。透過強制執行特定的規則和慣例，例如行距、縮排和運算子周圍的間距，程式碼在視覺上會變得更有條理且更容易理解。您可以在 autopep8 頁面上查看範例。請記住，格式化不會影響程式碼本身的功能。

程式碼檢查 有助於透過分析程式碼中常見的語法、樣式和功能錯誤以及非傳統的程式設計實務來預防錯誤。雖然格式化和程式碼檢查之間有一些重疊，但這兩項功能是互補的。

選擇格式器

在 VS Code Marketplace 中搜尋您選擇的格式器擴充功能。

Microsoft 發布了以下格式化擴充功能

社群提供的格式器擴充功能

此外，以下是支援匯入排序的格式器擴充功能

注意：如果您在上面的表格或 Marketplace 中找不到您偏好的格式器，您可以透過擴充功能新增對它的支援。您可以使用 Python 擴充功能範本 將新的 Python 工具整合到 VS Code 中。

設定預設格式器

一旦您安裝了格式器擴充功能，您可以按照以下步驟將其選為 VS Code 中 Python 檔案的預設格式器

1. 在 VS Code 中開啟 Python 檔案。
2. 在編輯器中按一下滑鼠右鍵以顯示內容功能表。
3. 選取使用...格式化文件。
4. 從下拉式功能表中選取設定預設格式器...。
5. 從清單中選取您偏好的格式器擴充功能。

或者，您可以透過在您的使用者 settings.json 檔案中的 [python] 範圍下設定 "editor.defaultFormatter"，將其設定為所有 Python 檔案的預設格式器。您可以使用偏好設定：開啟使用者設定 (JSON) 命令開啟 settings.json。

例如，若要將 Black Formatter 設定為預設格式器，請將以下設定新增至您的使用者 settings.json 檔案

  "[python]": {
    "editor.defaultFormatter": "ms-python.black-formatter"
  }

為了將格式器擴充功能設定為匯入排序器，您可以在您的使用者 settings.json 檔案或您的工作區 settings.json 檔案中的 [python] 範圍下設定您的偏好設定。您可以使用偏好設定：開啟使用者設定 (JSON) 和偏好設定：開啟工作區設定 (JSON) 命令分別開啟這些 settings.json 檔案。這將針對所有 Python 檔案啟用儲存時匯入排序。

例如，若要將 Ruff 設定為您偏好的匯入排序器，您可以將以下設定新增至您的使用者 settings.json 或您的工作區 settings.json 檔案

{
  "[python]": {
    "editor.codeActionsOnSave": {
      "source.organizeImports.ruff": "explicit"
    }
  }
}

格式化您的程式碼

您可以透過在編輯器中按一下滑鼠右鍵並選取格式化文件，或使用 ⇧⌥F (Windows Shift+Alt+F, Linux Ctrl+Shift+I) 鍵盤快速鍵來格式化您的程式碼。

您也可以將以下設定新增至您的使用者 settings.json 檔案，以針對您的程式碼啟用儲存時格式化

  "[python]": {
    "editor.formatOnSave": true
  }

一般格式化設定

您可以參考每個格式器擴充功能的 README 以取得有關支援設定的更多詳細資訊。大多數格式器擴充功能都支援以下設定

疑難排解格式化

如果格式化失敗，請檢查以下可能的原因

注意：如果您在上面找不到您偏好的格式器，您可以透過擴充功能新增支援。Python 擴充功能範本 可讓您輕鬆地將新的 Python 工具整合到 VS Code 中。

後續步驟

• 偵錯 - 學習在本機和遠端偵錯 Python。
• 測試 - 設定測試環境並探索、執行和偵錯測試。
• 基本編輯 - 了解功能強大的 VS Code 編輯器。
• 程式碼導覽 - 在您的原始碼中快速移動。
• Python 擴充功能範本 - 建立擴充功能以將您最愛的程式碼檢查器整合到 VS Code 中。