VS Code Python 快速入門指南
Python 延伸模組將 Visual Studio Code 打造成一套優秀的 Python 編輯器,它適用於任何作業系統,並可與各種 Python 直譯器搭配使用。
安裝以下內容以開始使用
- VS Code
- Python 直譯器(任何受官方支援的 Python 版本)
- 來自 VS Code Marketplace 的 Python 延伸模組

若要進一步針對 Python 自訂 VS Code,您可以善用 Python 設定檔範本,它會自動安裝建議的延伸模組與設定。對於資料科學專案,請考慮使用 資料科學設定檔範本。

如何建立並開啟 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 延伸模組後的介面。

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

Python 指令
Python 指令可以透過 命令選擇區 (Command Palette) (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 來存取。從命令選擇區中,您可以存取來自 VS Code 與已安裝延伸模組的各種功能。在命令選擇區中輸入「Python: 」即可尋找 Python 延伸模組所提供的可用指令。

執行、偵錯與測試
既然您對 VS Code 中的 Python 已經更加熟悉,讓我們來學習如何執行、偵錯與測試您的程式碼。
執行
在 VS Code 中執行 Python 程式碼有幾種方法。
若要執行您在編輯器中開啟的 Python 指令碼,請選取編輯器右上角的在終端機執行 Python 檔案播放按鈕。

此外,還有其他方式可以在 VS Code 中反覆執行您的 Python 程式碼片段。
- 選取一行或多行程式碼,然後按下 Shift+Enter,或是按一下右鍵並選取在 Python 終端機執行選取範圍/行。此指令對於僅測試檔案的一部分非常方便。
- 從命令選擇區 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中,選取 Python: 啟動 REPL 指令,為目前選定的 Python 直譯器開啟 REPL 終端機。在 REPL 中,您可以逐行輸入並執行程式碼。
偵錯
偵錯工具是一個非常有用的工具,它能讓您檢查程式碼的執行流程,更輕鬆地識別錯誤,並在程式執行時探索變數與資料的變化。您可以透過在想要檢查的程式碼行旁點擊裝訂邊 (gutter) 來設定中斷點,藉此啟動偵錯。

若要開始偵錯,請按 F5 初始化偵錯工具。由於這是您首次偵錯該檔案,系統會開啟設定選單,讓您選擇要偵錯的應用程式類型。如果是 Python 指令碼,您可以選擇Python 檔案。
當您的程式執行到中斷點時,它會停止,讓您能夠在 Python 偵錯主控台中追蹤資料,並使用偵錯工具列逐步執行您的程式。

若要深入了解 Python 偵錯功能,請參閱 在 VS Code 中進行 Python 偵錯。
測試
Python 延伸模組為 Unittest 和 pytest 提供了強大的測試支援。
您可以透過活動列 (Activity Bar) 上的「測試」檢視,選取設定 Python 測試並選擇您偏好的測試框架,來設定 Python 測試。
您也可以為 Python 專案建立測試,一旦設定好偏好的框架,Python 延伸模組便會嘗試自動探索這些測試。Python 延伸模組也允許您在「測試」檢視中執行與偵錯測試,並在「測試結果」面板中檢查測試執行輸出。

如需測試功能的全面概覽,請參閱 在 VS Code 中進行 Python 測試。
後續步驟
若要學習如何使用熱門的 Python 網路框架建置 Web 應用程式,請參閱下列教學課程:
在 Visual Studio Code 中,還有更多關於 Python 的功能等著您去探索