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 中開啟工作區資料夾,則可以直接將新檔案或資料夾新增至現有專案中。您可以利用檔案總管檢視中最上層資料夾的新增資料夾新增檔案圖示來建立新的資料夾與檔案。

使用者介面導覽

當您首次啟動 VS Code 時,需要安裝 Python 延伸模組才能取得 Python 專用的功能與介面。讓我們來看看安裝 Python 延伸模組後的介面。

Image of the Python UI highlights in VS Code.

程式碼動作 (Code Actions)

程式碼動作 (Code Actions,也稱為快速修復) 是為了在程式碼出現警告時協助修正問題而提供的。這些有用的提示會顯示在編輯器左側邊界,以燈泡圖示 (💡) 表示。選取燈泡圖示即可顯示程式碼動作選項。這些程式碼動作可能來自 Python、Pylance 等延伸模組,或是 VS Code 本身。如需關於程式碼動作的詳細資訊,請參閱 Python 快速修復

Screenshot showing Code Actions in a Python project.

Python 指令

Python 指令可以透過 命令選擇區 (Command Palette) (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 來存取。從命令選擇區中,您可以存取來自 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 中,您可以逐行輸入並執行程式碼。

偵錯

偵錯工具是一個非常有用的工具,它能讓您檢查程式碼的執行流程,更輕鬆地識別錯誤,並在程式執行時探索變數與資料的變化。您可以透過在想要檢查的程式碼行旁點擊裝訂邊 (gutter) 來設定中斷點,藉此啟動偵錯。

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 提供了強大的測試支援。

您可以透過活動列 (Activity Bar) 上的「測試」檢視,選取設定 Python 測試並選擇您偏好的測試框架,來設定 Python 測試。

您也可以為 Python 專案建立測試,一旦設定好偏好的框架,Python 延伸模組便會嘗試自動探索這些測試。Python 延伸模組也允許您在「測試」檢視中執行與偵錯測試,並在「測試結果」面板中檢查測試執行輸出。

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

如需測試功能的全面概覽,請參閱 在 VS Code 中進行 Python 測試

後續步驟

若要學習如何使用熱門的 Python 網路框架建置 Web 應用程式,請參閱下列教學課程:

在 Visual Studio Code 中,還有更多關於 Python 的功能等著您去探索

  • Python 設定檔範本 - 建立包含一組精選延伸模組、設定與程式碼片段的新 設定檔
  • 編輯程式碼 - 了解 Python 的自動完成、IntelliSense、格式化與重構功能。
  • Linting - 啟用、設定並套用各種 Python Linter。
  • 偵錯 - 學習如何在本地與遠端對 Python 程式進行偵錯。
  • 測試 - 設定測試環境,並探索、執行與偵錯測試。
  • 設定參考 - 探索 VS Code 中所有與 Python 相關的設定。
© . This site is unofficial and not affiliated with Microsoft.