如何設定 VSCode 編寫執行 Python 程式碼
VSCode 如何建構 Python 開發環境? VSCode 如何執行 Python 程式碼影片演示 YouTube
先決條件
在開始本節內容之前,請確保 Python 已被正確安裝,你可以檢視如何在 UNIX/Linux/Windows/macOS 中安裝 Python一節來取得相關資訊。
安裝 VSCode
VSCode(Visual Studio Code,VS Code)是一款強大有效的開發工具,通過安裝相關的延伸模組,他可以支援多種語言程式碼的編寫和偵錯,包括 Python 在內。
官方網站提供了不同版本的安裝套件和壓縮套件,以便開發人員可以在 Linux/Windows/macOS 上輕松使用 VSCode。你可以根據自己的需要,下載對應的安裝套件或壓縮套件,安裝的過程較為簡單,這裏略過。
安裝 VSCode 延伸模組 Python
要想在 VSCode 中執行和偵錯 Python 程式碼,你可以選擇安裝由微軟開發的 VSCode 延伸模組Python
(ms-python.python),他提供了 Python 開發所需的常用功能。該延伸模組可通過延伸模組面板的搜尋功能找到,你需要根據情況選擇安裝或啟用他,如果已處於啟用狀態則無需任何操作。
如何設定 VSCode 所使用的 Python 解譯器版本?
如果你擁有多個版本的 Python,那麽可通過以下方式選擇其中一個作為 VSCode 的 Python 解譯器。
使用命令面板的鍵盤快速鍵(Linux/Windows 中預設為Ctrl+Shift+P,macOS 中預設為⇧+⌘+P)開啟 VSCode 的命令面板,輸入並執行命令Python: Select Interpreter
,即可新增和選擇某個版本的 Python 解譯器。
延伸模組 Python 需要其他延伸模組來實作更多功能
由於延伸模組Python
並不具備某些功能的具體實作,因此在安裝延伸模組Python
後,通常還需要繼續安裝一些其他的延伸模組。比如,你可以安裝實作程式碼智能提示和自動完成的Pylance
,安裝實作程式碼格式化的autopep8
,Black Formatter
,安裝實作程式碼錯誤修正和質量檢查的Pylint
,Flake8
。
以上這些延伸模組的安裝方法與延伸模組Python
類似,部分延伸模組可能需要重新啟動 VSCode 才能生效。
安裝 VSCode 延伸模組 Pylance
延伸模組Pylance
(ms-python.vscode-pylance)為 VSCode 提供了 Python 程式碼的診斷分析,智能提示和自動完成等功能。由於Pylance
是延伸模組Python
所選擇的預設語言伺服器,因此他一般會跟隨延伸模組Python
一同安裝。
如何為 VSCode 指定預設的 Python 語言伺服器?
你可以通過修改 VSCode 的設定項python.languageServer
,來指定預設的 Python 語言伺服器,當然,在本節中我們應該將其設定為Default
或Pylance
,以確保延伸模組Pylance
被采用。要完成以上目標,需要在設定面板中搜尋@id:python.languageServer
,或直接編輯settings.json
檔案。
Pylance 使用和設定說明
想要詳細了解延伸模組Pylance
的使用和設定,你可以檢視VSCode Pylance 延伸模組的使用和設定說明一節。
安裝 VSCode 延伸模組 autopep8,Black Formatter
延伸模組autopep8
(ms-python.autopep8),Black Formatter
(ms-python.black-formatter)為 VSCode 提供了 Python 程式碼的格式化功能。
如何為 VSCode 指定預設的 Python 格式器?
當你同時啟用了延伸模組autopep8
和Black Formatter
,並且尚未指定預設的格式器時,VSCode 會在適當的時機要求你做出選擇,這些選擇可通過在設定面板中搜尋@lang:python editor.defaultFormatter
,或編輯settings.json
檔案進行修改,如果是編輯settings.json
,那麽editor.defaultFormatter
設定項應被設定為ms-python.autopep8
或ms-python.black-formatter
。
autopep8 使用和設定說明
想要詳細了解延伸模組autopep8
的使用和設定,你可以檢視VSCode autopep8 延伸模組的使用和設定說明一節。
安裝 VSCode 延伸模組 Pylint,Flake8
延伸模組Pylint
(ms-python.pylint),Flake8
(ms-python.flake8)為 VSCode 提供了 Python 程式碼的錯誤修正和質量檢查功能。他們會檢查已經開啟的 Python 腳本檔案,並將檢查結果反饋給開發人員。
在 VSCode 中編寫 Python 程式碼
在相關延伸模組準備完畢後,你可以在 VSCode 中開啟任意一個資料夾作為工作區,如果被詢問您是否信任此資料夾中檔案的作者?,選擇是,我信任作者。
在檔案總管面板中新增任意一個副檔名為py
的 Python 的腳本檔案,比如hello_world.py
。在該檔案中書寫程式碼,呼叫print
函式顯示歡迎資訊,相關的延伸模組會有所回應,比如,顯示print
函式的使用說明。
print('你好,Python!')
在 VSCode 中執行 Python 程式碼
VSCode 為我們提供了多種執行或偵錯 Python 程式碼的方法。
比如,點選程式碼視窗中的執行/偵錯按鈕,將執行或偵錯目前視窗對應的 Python 腳本檔案。或者開啟執行與偵錯面板,點選建立 launch.json 檔案並選擇 Python Debugger | Python 檔案(如果需要的話),這將在launch.json
檔案中新增用於執行偵錯目前 Python 腳本檔案的組態,此時,按下F5即可執行偵錯目前使用中的 Python 檔案。
如果launch.json
檔案不存在或該檔案中沒有相關的組態,則按下F5後,需要選擇一個可用的組態以啟動執行或偵錯。
你好,Python!