快捷導(dǎo)航

在VSCode中配置Python開(kāi)發(fā)環(huán)境的詳細(xì)教程

更新時(shí)間：2025年04月21日 11:42:42 作者：一個(gè)不務(wù)正業(yè)的程序猿

Visual Studio Code（簡(jiǎn)稱VSCode）以其強(qiáng)大的功能和靈活的擴(kuò)展性,成為了許多開(kāi)發(fā)者的首選,本文將詳細(xì)介紹如何在VSCode中配置Python開(kāi)發(fā)環(huán)境,需要的朋友可以參考下

一、VSCode配置Python開(kāi)發(fā)環(huán)境

1、軟件安裝

在開(kāi)始配置之前，需要準(zhǔn)備以下軟件：

Python：參考：Python入門教程之Python的安裝下載配置_python_腳本之家
VSCode：從VS Code官網(wǎng)（https://code.visualstudio.com/）下載并安裝。安裝過(guò)程非常簡(jiǎn)單，只需一路點(diǎn)擊“下一步”即可完成。

2、安裝Python插件

下面是Python常見(jiàn)的插件及其作用

Python：集成開(kāi)發(fā)環(huán)境的擴(kuò)展程序，它使開(kāi)發(fā)者可以在VS Code編輯器中輕松地編寫(xiě)、調(diào)試和運(yùn)行Python代碼。
Python Debugger：為Python開(kāi)發(fā)者設(shè)計(jì)的一個(gè)調(diào)試工具，它提供了強(qiáng)大的調(diào)試功能。
Python for VSCode：幫助開(kāi)發(fā)者在VS Code編輯器中更加高效地編寫(xiě)、調(diào)試和運(yùn)行Python代碼。
Python Environment Manager：提供一個(gè)集中化的界面，方便用戶查看和管理所有的Python環(huán)境和包。

通過(guò)Ctrl+Shift+X打開(kāi)插件面板，輸入"Python"搜索并安裝相關(guān)的插件。安裝完成插件之后，通常需要重啟 VS Code，以啟用安裝的插件：

在這里插入圖片描述

3、配置Python環(huán)境

Step 1：創(chuàng)建Python項(xiàng)目文件夾

創(chuàng)建一個(gè)文件夾作為項(xiàng)目的工作區(qū)，并通過(guò)VS Code打開(kāi)，點(diǎn)擊 “文件” > “選擇文件夾” 選擇目標(biāo)文件夾

在這里插入圖片描述

Step 2：選擇Python解釋器

使用Ctrl+Shift+P打開(kāi)命令面板，輸入"Python: 選擇解釋器"，然后從列表中選擇已安裝的 Python 解釋器。

在這里插入圖片描述

Step 3：創(chuàng)建虛擬環(huán)境（可選）

Python虛擬環(huán)境是一種用于隔離Python項(xiàng)目依賴的機(jī)制。每個(gè)虛擬環(huán)境都擁有自己獨(dú)立的Python解釋器、庫(kù)和腳本。通過(guò)為每個(gè)項(xiàng)目創(chuàng)建獨(dú)立的虛擬環(huán)境，可以確保每個(gè)項(xiàng)目的依賴項(xiàng)都是獨(dú)立的，從而避免不同項(xiàng)目之間的依賴沖突。

使用Ctrl+Shift+P打開(kāi)命令面板，輸入"Python: 創(chuàng)建環(huán)境"，可以選擇Venv與Conda環(huán)境，兩個(gè)環(huán)境創(chuàng)建過(guò)程基本一致，下面以Venv環(huán)境為例講下創(chuàng)建流程。

選擇Venv環(huán)境類型

在這里插入圖片描述

選擇Python解釋器

在這里插入圖片描述

提示正在創(chuàng)建虛擬環(huán)境

在這里插入圖片描述

工作區(qū)多了一個(gè).venv文件夾

在這里插入圖片描述

Step 4：激活虛擬環(huán)境（可選）

虛擬環(huán)境允許你為每個(gè)項(xiàng)目創(chuàng)建獨(dú)立的Python環(huán)境，每個(gè)環(huán)境都有自己的Python解釋器和安裝的庫(kù)。激活虛擬環(huán)境可以確保你在當(dāng)前項(xiàng)目中使用的Python解釋器和庫(kù)是該項(xiàng)目特定的，而不是全局安裝的或其他項(xiàng)目的。虛擬環(huán)境創(chuàng)建之后會(huì)自動(dòng)激活，下面是幾種判斷虛擬環(huán)境是否激活的方法：

方法一：通過(guò) VS Code 設(shè)置檢查

使用Ctrl+Shift+P打開(kāi)命令面板，輸入"Python:選擇解釋器"，查看當(dāng)前設(shè)置的 Python 解釋器路徑，如果它指向你的虛擬環(huán)境，則虛擬環(huán)境已經(jīng)激活。

在這里插入圖片描述

方法二：通過(guò) Python 解釋器檢查

在終端中輸入 python 或 python3 并回車。
在 Python 提示符下，可以運(yùn)行以下命令來(lái)檢查當(dāng)前 Python 環(huán)境。
將打印出當(dāng)前激活的 Python 解釋器的路徑，如果路徑指向你的虛擬環(huán)境目錄，則說(shuō)明虛擬環(huán)境已經(jīng)激活

import sys
print(sys.executable)

Step 5：新建Python文件

新建文件，并把文件后綴修改成.py

在這里插入圖片描述

Step 6：運(yùn)行程序

點(diǎn)擊左上角的按鍵可以運(yùn)行Python程序，運(yùn)行時(shí)可能會(huì)遇到下面的報(bào)錯(cuò)

無(wú)法加載文件 E:\Py_Workspace\hello.venv\Scripts\Activate.ps1，因?yàn)樵诖讼到y(tǒng)上禁止運(yùn)行腳本

在這里插入圖片描述

這表明你的PowerShell執(zhí)行策略阻止了.ps1腳本的執(zhí)行。PowerShell執(zhí)行策略是一種安全機(jī)制，用于限制可以運(yùn)行的腳本類型，以防止?jié)撛诘陌踩L(fēng)險(xiǎn)。要解決這個(gè)問(wèn)題，可以采取以下步驟：

在Windows搜索欄中輸入“PowerShell”，然后右鍵點(diǎn)擊“Windows PowerShell”并選擇“以管理員身份運(yùn)行”。
輸入以下命令之一來(lái)更改執(zhí)行策略。這些命令會(huì)要求你確認(rèn)更改。
- Set-ExecutionPolicy RemoteSigned：允許你運(yùn)行本地創(chuàng)建的腳本和從Internet下載的已簽名的腳本。
- Set-ExecutionPolicy Unrestricted：允許你運(yùn)行所有腳本，無(wú)論它們是否已簽名。

在這里插入圖片描述

4、包管理

pip是Python自帶的包管理器，它可以幫助我們安裝、升級(jí)和卸載Python包。Python包是一組Python模塊，它們可以提供各種功能，例如數(shù)據(jù)分析、Web開(kāi)發(fā)、機(jī)器學(xué)習(xí)等等。pip常用的命令，如下：

命令	功能
pip install package_name	安裝一個(gè)包
pip install --upgrade package_name	升級(jí)一個(gè)包
pip uninstall package_name	卸載一個(gè)包
pip list	查看已安裝的包
pip show package_name	查看包的詳細(xì)信息