現已釋出!閱讀關於 11 月新增功能和修復的內容。

Visual Studio Code 中的 Python

使用 Microsoft Python 擴充套件 在 Visual Studio Code 中處理 Python 既簡單又有趣,效率也很高。該擴充套件使 VS Code 成為一個出色的 Python 編輯器,並且可以在任何作業系統上使用各種 Python 直譯器。它利用 VS Code 的所有強大功能來提供自動完成和 IntelliSense、程式碼檢查、除錯和單元測試,同時還能輕鬆切換 Python 環境,包括虛擬環境和 conda 環境。

本文僅概述了 VS Code 的 Python 擴充套件的各種功能。要了解編輯、執行和除錯程式碼的演練,請使用下面的按鈕。

Python 教程

安裝 Python 和 Python 擴充套件

教程將引導您完成 Python 的安裝以及該擴充套件的使用。您必須單獨安裝 Python 直譯器,而不是隨擴充套件一起安裝。對於快速安裝,請使用 python.org 提供的 Python 並從 VS Code Marketplace 中 安裝該擴充套件

注意:為了幫助您開始 Python 開發,您可以使用 Python 配置模板,其中包含有用的擴充套件、設定和 Python 程式碼片段。

安裝了 Python 版本後,請使用“Python: Select Interpreter”命令進行選擇。如果 VS Code 未自動找到您要查詢的直譯器,請參閱 環境 - 手動指定直譯器

您可以透過設定來配置 Python 擴充套件。有關詳細資訊,請參閱 Python 設定參考

Windows Subsystem for Linux:如果您使用的是 Windows,WSL 是進行 Python 開發的絕佳選擇。您可以在 Windows 上執行 Linux 發行版,並且 Python 通常已預裝。結合 WSL 擴充套件,您可以在 WSL 的上下文中獲得完整的 VS Code 編輯和除錯支援。要了解更多資訊,請轉到 在 WSL 中開發 或嘗試 在 WSL 中工作 教程。

執行 Python 程式碼

要體驗 Python,請建立一個名為 hello.py 的檔案(使用 檔案資源管理器),然後貼上以下程式碼

print("Hello World")

然後,Python 擴充套件會提供快捷方式,使用當前選定的直譯器(在命令面板中選擇“Python: Select Interpreter”)來執行 Python 程式碼。要執行活動的 Python 檔案,請點選編輯器右上角的“Run Python File”播放按鈕。

Using the run python file in terminal button

您還可以使用“Python: Run Selection/Line in Python Terminal”命令(Shift+Enter)執行單獨的行或程式碼塊。如果沒有選定程式碼,智慧傳送(Smart Send)會將您游標所在行的最小可執行程式碼塊傳送到 Python 終端(透過 Shift+Enter)。在編輯器的選定區域的上下文選單中,有一個相同的“Run Python > Run Selection/Line in Python Terminal”命令。在關閉該終端之前,每次執行選定行或終端/REPL 中的一行時,都會使用相同的終端。執行 Python 檔案時也會使用相同的終端。如果該終端仍在執行 REPL,您應該退出 REPL(exit())或切換到其他終端,然後再執行 Python 檔案。

Python 擴充套件會根據選定行的第一個非空行自動刪除縮排,並將所有其他行向左移動,以滿足要求。

該命令會在必要時開啟 Python 終端;您還可以使用“Python: Start Terminal REPL”命令直接開啟互動式 REPL 環境,該命令會啟用一個帶有當前選定直譯器的終端,然後執行 Python REPL。

有關更具體的演練和其他執行程式碼的方法,請參閱 執行程式碼教程

自動完成和 IntelliSense

Python 擴充套件使用當前選定的直譯器支援程式碼補全和 IntelliSense。 IntelliSense 是一個通用術語,指代一系列功能,包括智慧程式碼補全(上下文方法和變數建議),涵蓋所有檔案以及內建和第三方模組。

IntelliSense 會在您鍵入時快速顯示方法、類成員和文件。您還可以隨時透過 ⌃Space(Windows、Linux Ctrl+Space 觸發補全。將滑鼠懸停在識別符號上會顯示有關它們的更多資訊。

IntelliSense and autocomplete for Python code

使用 AI 增強補全

GitHub Copilot 是一款由 AI 驅動的程式碼補全工具,可以幫助你更快、更智慧地編寫程式碼。你可以在 VS Code 中使用 GitHub Copilot 擴充套件來生成程式碼,或從其生成的程式碼中學習。

GitHub Copilot extension in the VS Code Marketplace

GitHub Copilot 可為 Python 以外的語言和各種框架提供建議,包括 JavaScript、TypeScript、Ruby、Go、C# 和 C++。

你可以在Copilot 文件中瞭解更多關於如何開始使用 Copilot 的資訊。

程式碼檢查

程式碼檢查會分析您的 Python 程式碼中的潛在錯誤,讓您輕鬆定位和糾正各種問題。

Python 擴充套件可以應用多種不同的程式碼檢查器,包括 Pylint、pycodestyle、Flake8、mypy、pydocstyle、prospector 和 pylama。請參閱 程式碼檢查

除錯

告別 print 語句除錯!VS Code 透過 Python Debugger 擴充套件為 Python 提供了出色的除錯支援,允許您設定斷點、檢查變數,並使用除錯控制檯逐行深入瞭解程式的執行情況。您可以除錯多種不同型別的 Python 應用程式,包括多執行緒、Web 和遠端應用程式。

有關 Python 除錯的更多具體資訊,例如配置 launch.json 設定和實現遠端除錯,請參閱 除錯。常規 VS Code 除錯資訊可在 除錯文件 中找到。

此外,DjangoFlask 教程提供了有關如何在 Web 應用程式的上下文中實現除錯的示例,包括除錯 Django 模板。

環境

Python 擴充套件會自動檢測安裝在標準位置的 Python 直譯器。它還會檢測工作區資料夾中的 conda 環境以及虛擬環境。請參閱 配置 Python 環境

當前環境顯示在 VS Code 狀態列的右側

Status Bar showing a selected interpreter

狀態列還會指示是否未選擇直譯器

Status bar showing no selected Python interpreter

選定的環境用於 IntelliSense、自動完成、程式碼檢查、格式化以及任何其他與語言相關的功能。當您在終端中執行或除錯 Python,或使用“Terminal: Create New Terminal”命令建立新終端時,也會啟用該環境。

要更改當前直譯器,包括切換到 conda 或虛擬環境,請在狀態列中選擇直譯器名稱,或使用“Python: Select Interpreter”命令。

Python: Select Interpreter command

VS Code 會向您顯示檢測到的環境列表,以及您已手動新增到使用者設定的任何環境(請參閱 配置 Python 環境)。

Jupyter Notebook

要為 VS Code 中的 Jupyter Notebook 檔案(.ipynb)啟用 Python 支援,您可以安裝 Jupyter 擴充套件。Python 和 Jupyter 擴充套件協同工作,為您提供 VS Code 中的出色 Notebook 體驗,使您能夠直接使用 IntelliSense 支援檢視和修改程式碼單元格,以及執行和除錯它們。

Jupyter notebook running in VS code in the Notebook Editor

您還可以透過“Jupyter: Export to Python Script”命令將 Notebook 轉換為 Python 程式碼檔案並開啟。Notebook 的單元格在 Python 檔案中用 #%% 註釋分隔,Jupyter 擴充套件會顯示“Run Cell”或“Run Below” CodeLens。選擇任一 CodeLens 都會啟動 Jupyter 伺服器並在 Python 互動式視窗中執行單元格。

Jupyter notebook running in VS Code and the Python interactive window

您還可以連線到遠端 Jupyter 伺服器來執行您的 Notebook。有關更多資訊,請參閱 Jupyter 支援

測試

Python 擴充套件支援使用 Python 內建的 unittest 框架和 pytest 進行 測試

要執行測試,您必須在專案的設定中啟用一個受支援的測試框架。每個框架都有自己的特定設定,例如用於標識測試發現的路徑和模式的引數。

一旦測試被發現,VS Code 就會在狀態列、命令面板和其他地方提供各種命令來執行和除錯測試。這些命令還允許您執行單個測試檔案和方法。

配置

Python 擴充套件為其各種功能提供廣泛的設定。這些設定將在相關主題中進行描述,例如 編輯程式碼程式碼檢查除錯測試。完整列表可在 設定參考 中找到。

Python 配置模板

配置允許您根據當前專案或任務快速切換擴充套件、設定和 UI 佈局。為了幫助您開始 Python 開發,您可以使用 Python 配置模板,這是一個包含有用擴充套件、設定和程式碼片段的精選配置。您可以按原樣使用該配置模板,或將其作為起點,進一步根據自己的工作流進行自定義。

您透過“**配置檔案**”>“**建立配置檔案...**”下拉選單選擇一個配置檔案模板

Create Profile dropdown with profile templates

選擇配置模板後,您可以檢視設定和擴充套件,如果您不想將某些專案包含在新配置中,可以將其刪除。在基於模板建立新配置後,對設定、擴充套件或 UI 所做的更改將保留在您的配置中。

Microsoft Python 擴充套件提供了本文前面介紹的所有功能。透過安裝其他流行的 Python 擴充套件,可以為 VS Code 新增額外的 Python 語言支援。

  1. 開啟“Extensions”檢視(⇧⌘X(Windows、Linux Ctrl+Shift+X)。
  2. 透過鍵入“python”來篩選擴充套件列表。

上面顯示的擴充套件是動態查詢的。點選上面的擴充套件卡片即可閱讀說明和評論,以決定哪個擴充套件最適合您。有關更多資訊,請參閱 Marketplace

後續步驟

© . This site is unofficial and not affiliated with Microsoft.