參加你附近的 ,瞭解 VS Code 中的 AI 輔助開發。

VS Code 中的 Python 快速入門指南

Python 擴充套件使 Visual Studio Code 成為一款出色的 Python 編輯器,它適用於任何作業系統,並可與多種 Python 直譯器配合使用。

首先請安裝

Gif installing the Python extension in a fresh install of VS Code

要進一步為 Python 定製 VS Code,您可以利用 Python 配置檔案模板,它會自動安裝推薦的擴充套件和設定。對於資料科學專案,可以考慮使用資料科學配置檔案模板

Gif showing the Python profile template being installing into VS Code.

如何建立和開啟 Python 專案或檔案

如果您希望在 VS Code 中處理現有的 Python 專案,可以從 VS Code 的“歡迎”頁面或“檔案資源管理器”檢視中開啟您的資料夾或檔案,或選擇 檔案 > 開啟資料夾Ctrl+K Ctrl+O)或 檔案 > 開啟檔案⌘O (Windows, Linux Ctrl+O))。

您可以透過在 VS Code 的“歡迎”頁面上選擇 新建檔案,然後選擇 Python 檔案 來建立新的 Python 檔案,或者透過導航到 檔案 > 新建檔案)來建立。

提示: 如果您已在 VS Code 中打開了一個工作區資料夾,您可以直接在現有專案中新增新檔案或資料夾。您可以透過使用“檔案資源管理器”檢視中頂級資料夾上的相應 新建資料夾新建檔案 圖示來建立新的資料夾和檔案。

UI 導覽

當您首次啟動 VS Code 時,需要安裝 Python 擴充套件以獲得 Python 特定的功能和使用者介面。我們來看看安裝 Python 擴充套件後的介面。

Image of the Python UI highlights in VS Code.

程式碼操作

程式碼操作(也稱為“快速修復”)旨在幫助修復程式碼中出現警告時的問題。這些有用的提示會以燈泡(💡)的形式顯示在編輯器的左邊距。選擇燈泡以顯示程式碼操作選項。這些程式碼操作可以來自 Python、Pylance 等擴充套件或 VS Code 本身。有關程式碼操作的更多資訊,請參閱 Python 快速修復

Screenshot showing Code Actions in a Python project.

Python 命令

可以透過命令面板⇧⌘P (Windows, Linux Ctrl+Shift+P))訪問 Python 命令。透過命令面板,您可以訪問 VS Code 和已安裝擴充套件的各種功能。在命令面板中輸入 “Python: ” 即可查詢 Python 擴充套件提供的命令。

Gif demonstrating how to access Python commands in the Command Palette.

執行、除錯和測試

現在您對 VS Code 中的 Python 更加熟悉了,讓我們來學習如何執行、除錯和測試您的程式碼。

執行

在 VS Code 中有幾種執行 Python 程式碼的方法。

要執行您在編輯器中開啟的 Python 指令碼,請選擇編輯器右上角的 在終端中執行 Python 檔案 播放按鈕。

Image showing the Run Python File in Terminal play button.

還有其他方法可以在 VS Code 中迭代執行您的 Python 程式碼片段:

  • 選擇一行或多行,然後按 Shift+Enter 或右鍵單擊並選擇 在 Python 終端中執行選中內容/行。此命令便於僅測試檔案的一部分。
  • 從命令面板(⇧⌘P (Windows, Linux Ctrl+Shift+P))中,選擇 Python: 啟動 REPL 命令,為當前選定的 Python 直譯器開啟一個 REPL 終端。在 REPL 中,您可以一次輸入並執行一行程式碼。

除錯

偵錯程式是一個有用的工具,它允許您檢查程式碼的執行流程,更輕鬆地識別錯誤,並探索程式執行時變數和資料的變化。您可以透過在 Python 專案中單擊您希望檢查的程式碼行旁邊的邊欄來設定斷點,從而開始除錯。

Screenshot showing a debugger breakpoint in a Python program.

要開始除錯,請按 F5 初始化偵錯程式。由於這是您第一次除錯此檔案,將開啟一個配置選單,允許您選擇要除錯的應用程式型別。如果它是一個 Python 指令碼,您可以選擇 Python 檔案

一旦您的程式到達斷點,它將停止,並允許您在 Python 除錯控制檯中跟蹤資料,並使用除錯工具欄逐步執行您的程式。

Gif showing how to configure the Python debugger for the first time.

要深入瞭解 Python 除錯功能,請參閱 在 VS Code 中進行 Python 除錯

測試

Python 擴充套件為 Unittestpytest 提供了強大的測試支援。

您可以透過活動欄上的“測試”檢視,選擇 配置 Python 測試 並選擇您偏好的測試框架來配置 Python 測試。

您還可以為您的 Python 專案建立測試,一旦您選擇的框架配置好,Python 擴充套件將嘗試發現這些測試。Python 擴充套件還允許您在“測試”檢視中執行和除錯您的測試,並在“測試結果”面板中檢查測試執行的輸出。

Gif demonstrating test configuration, discovery, and run in the Python extension.

要全面瞭解測試功能,請參閱 在 VS Code 中進行 Python 測試

後續步驟

要學習如何使用流行的 Python Web 框架構建 Web 應用程式,請參閱以下教程:

在 Visual Studio Code 中使用 Python 還有更多值得探索的內容:

  • Python 配置檔案模板 - 使用一組精選的擴充套件、設定和程式碼片段建立一個新的配置檔案
  • 編輯程式碼 - 瞭解 Python 的自動完成、IntelliSense、格式設定和重構。
  • Linting - 啟用、配置和應用各種 Python linter。
  • 除錯 - 瞭解如何在本地和遠端除錯 Python。
  • 測試 - 配置測試環境以及發現、執行和除錯測試。
  • 設定參考 - 探索 VS Code 中所有與 Python 相關的設定。