VSCode配置Python教程

• 本文基於Windows系統
• 超詳細VSCode安裝教程（Windows）
• 博主的VSCode專欄：分享使用VS Code的基本操作與各種技巧
  

---

剛剛開始學習Python時，按照老師提供的傻瓜式操作配好Python後，發現它自帶了一個ide：IDLE，

• IDLE足夠輕量級，打開速度很快，沒有太多雜亂的東西（即使它們對於老手非常好用，但會對新手產生各種各樣的干擾）
• IDLE自帶的Python Shell是可以交互式的，那時候對於初學Python的我來說，可以快速編輯的學習Python知識點
• 但是，IDLE終歸在送我入門後被我拋棄了，因爲界面不美觀、操作不智能、功能不強大…

我知道有一個很強大的ide：PyCharm，不過，嗯~~~，我沒使用過，就直接轉入Anaconda的懷抱了
不過，有的時候，過於專業、強大的功能也意味這軟件的“沉重性”（打開它是真滴慢）

VSCode官網中有這麼一句話，很有意思

If your primary purpose for using Python is Data Science, then you might consider a download from Anaconda. Anaconda provides not just a Python interpreter, but many useful libraries and tools for data science

即：如果你主要使用Python進行數據科學，推薦下載使用Anaconda

不過，我日常有時候只想寫一些簡單的Python代碼而已，於是，VSCode進入了我的視線；
遂打算使用VSCode配置Python環境，滿足我偶爾的Python語言編程需要，同時也將這個過程記錄下來，希望能幫助大家

目錄一：Python extension

1. 打開VSCode
2. 點擊側邊欄的Manage extensions圖標
   
3. 搜索Python，點擊install即可
   

在VSCode中編寫Python代碼，除了安裝上述插件，還需要自行安裝Python編譯器

目錄二：Python

第一步：下載Python解釋器

（如果你懶得去官網下載Python，可以直接使用我提供的Python3.8.2的下載鏈接 藍奏雲鏈接：python-3.8.2-amd64.exe）

Python官方下載網站 - Download the latest version for Windows

1. 選擇自己需要的Python版本進行download，跳轉到另一個頁面

2. 然後下拉到頁面底部，可以看到多個系統供你選擇
   macOS、
   Windows x86-64（64位）
   Windows x86（32位）

3. Windows系統有三種文件供你下載
   embeddable zip file，壓縮包文件
   web-based installer，網絡安裝，即下載之後，運行這玩意時它聯網下載Python
   executable installer，是exe文件，提供界面化安裝指導

我使用的是executable installer，因爲我不僅僅只是需要Python編譯器，我喜歡用IDLE寫一些簡單的Python代碼，因爲它足夠輕量級

補充：如果你需要使用多個版本的Python，請勾選第二個界面中py launcher，它會幫助你查找和執行不同的Python版本

第二步：配置環境變量

如果你在使用安裝程序安裝Python的時候沒有勾選 Add Python x.x to PATH ，請參考此內容

右鍵此電腦 > 屬性 > 高級系統設置 > 高級 > 環境變量

選中Path，點擊編輯

還要點擊多次確定哦，將剛剛打開的頁面全部通過確定關掉

假設我的安裝路徑爲：D:\Python，則配置的環境變量爲：

• D:\Python 配置Python編譯器的環境變量
• D:\Python\Scripts 配置pip的環境變量，我們通過pip安裝、管理包時，需要用到這個環境變量
• 如果你在使用安裝程序安裝Python的時候勾選了 py launcher ，請檢查環境變量PATH中是否配置以下路徑，若無則加上
  • C:\Users\用戶名\AppData\Local\Programs\Python\Launcher\
  • 路徑中的用戶名，你應該知道該怎麼填吧~

第三步：檢查並更新pip

win + r，輸入cmd，

• 在控制檯中輸入以下命令

py -3 --version

如此即可說明，下載成功了

• 將pip更新到最新版本（pip的典型應用是從PYPI（Python Package Index）上安裝Python第三方包）
  在控制檯中輸入以下命令

python -m pip install --upgrade pip

如果沒有反應，輸入以下命令：

py -m pip install --upgrade pip

請等待它下載完

目錄三：建立Python工作區

在下面的操作中，經過一些設置後，會在工作區下生成一些配置文件，而它們只在當前工作區中生效，不是全局的（全局設置本文不講，因爲看完工作區的設置並對配置文件有了一點概念之後，全局設置你會得心應手的）

一：新建一個文件夾用於存放你編寫的Python代碼，位置自己決定，不建議放到桌面

我直接將文件夾取名爲 Python

二：用VSCode打開Python文件夾

1. 最乾脆的辦法：選中文件夾 > 鼠標右鍵 > 通過Code打開

2. 如果VSCode沒有註冊到你的右鍵菜單中，你就老老實實的打開VSCode > file > open folder

三：選擇解釋器

Python是一個解釋性語言，現在你需要告知VSCode使用哪個解釋器

opening the Command Palette (Ctrl+Shift+P), start typing the Python: Select Interpreter command to search

簡單來說就是，在VSCode中，Ctrl+Shift+P 或者 View > Command Palette，打開命令面板
輸入Python: Select Interpreter

選擇Python的安裝路徑（由於我還安裝過Anaconda，所以有兩個Python解釋器）

此時，VSCode自動爲你生成settings.json文件在.vscode文件夾中

四：Linter pylint

先新建一個Python文件

VSCode右下角會出現下面的提示，install即可

Linter pylint告訴VS Code將此文件.py解釋爲Python程序，以便VSCode使用Python擴展名和選定的解釋器

下載完此插件後，它給出了一個提示

按照它的要求進行環境變量配置，將它給的路徑添加到環境變量中即可

目錄四：運行Python代碼的三種方法

運行代碼前請 ctrl + s，保存代碼哦

方法一：點擊按鈕

這個方法最簡單
只需單擊編輯器右上角的 “Run Python File in Terminal” 按鈕即可

該按鈕將打開一個終端面板，在其中自動激活您的Python解釋器，然後運行python test.py

方法二：右鍵菜單

右鍵單擊編輯器窗口中的任何位置

右鍵菜單中有這麼兩個選項

• Run Python File in Terminal（它會運行完整代碼，並在運行之前爲你保存代碼）
• Run Selection/Line in Python Terminal（它是用來運行部分代碼的，有的時候非常好用）
  請選中部分代碼，然後右鍵 > Run Selection/Line in Python Terminal，或者Shift + Enter

方法三：交互式解釋器

Ctrl + Shift + P 或者 View > Command Palette，打開命令面板
輸入Python: Start REPL

打開交互式解釋器，與IDLE的Python Shell功能一樣

交互式解釋器可以很方便的用來測試一些Python語法

目錄五：Debug

一：設置斷點

在某一行代碼的行號左邊，單擊以下，出現紅色的圓點

二：初始化調試器

F5 或者 Run > Start Debugging

由於這是第一次調試此文件，因此將從“命令面板”中打開一個配置菜單，有許多調試配置類型可供我們選擇

選擇 Python File （使用當前選擇的Python解釋器運行編輯器中顯示的當前文件的配置）

調試也是一種特殊的運行，調試器會在斷點處的第一行停止


補充一點：
在VSCode中，進行調試工作時，可以改用Logpoints代替常用的print快速檢查變量。Logpoints類似於斷點，不同之處在於它將消息記錄到控制檯並且不會停止程序。

有興趣的，可以官網：Logpoints

目錄六：虛擬環境中安裝、使用軟件包

Python發展至今，有大量優秀的代碼包供我們調用

最常用的就是在PYPI（Python Package Index）上安裝Python第三方包

一：

• 當你的Python代碼中調用了第三方包
• 除非你使用的是Anaconda或以前已經安裝過matplotlib包，你應該看到消息"ModuleNotFoundError：No module named ‘XXX’"
• 這樣的消息表明所需的軟件包在您的系統中不可用

二：

• 我們最好避免將軟件包安裝到全局解釋器環境中，最好使用的是特定於項目的虛擬環境，其中包含全局解釋器的副本
• 激活該環境後，隨後安裝的所有軟件包都將與其他環境隔離。這種隔離減少了因版本衝突而引起的許多複雜情況。

三：創建、激活虛擬環境

• 創建新的虛擬環境時，VS Code會提示您將其設置爲工作區文件夾的默認環境。如果選擇此選項，則在打開新終端時將自動激活環境
• Ctrl + Shift + ` 或者 Terminal > New Terminal，打開集成終端
• 輸入以下命令

py -3 -m venv .venv

若你在終端中輸入以上命令時出現Activate.ps1 is not digitally signed. You cannot run this script on the current system，直接在終端中輸入Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process命令來允許PowerShell執行腳本

命令輸入後，出現以下提示消息

點擊 Yes，等價於以下命令（激活虛擬環境）

.venv\scripts\activate

此時，在工作區下，VSCode會生成.venv文件夾，其子文件夾Scripts、Lib\site-packages存放我們在此工作區中安裝的packages

在VSCode中，Ctrl+Shift+P 或者 View > Command Palette，打開命令面板
輸入Python: Select Interpreter，選擇你所需的Python版本調試器

若需要安裝xxx包，只需要打開集成終端，輸入以下命令即可

python -m pip install xxx

三：關閉、開啓虛擬環境

關閉

deactivate

開啓

.venv\scripts\activate

---

參考資料：

• Python - Visual Studio Marketplace
• Python in Visual Studio Code