腳本之家服務(wù)器常用軟件

快捷導航

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

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

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

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

1、軟件安裝

在開始配置之前，需要準備以下軟件：

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

2、安裝Python插件

下面是Python常見的插件及其作用

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

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

在這里插入圖片描述

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

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

創(chuàng)建一個文件夾作為項目的工作區(qū)，并通過VS Code打開，點擊 “文件” > “選擇文件夾” 選擇目標文件夾

在這里插入圖片描述

Step 2：選擇Python解釋器

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

在這里插入圖片描述

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

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

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

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

在這里插入圖片描述

選擇Python解釋器

在這里插入圖片描述

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

在這里插入圖片描述

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

在這里插入圖片描述

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

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

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

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

在這里插入圖片描述

方法二：通過 Python 解釋器檢查

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

import sys
print(sys.executable)

Step 5：新建Python文件

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

在這里插入圖片描述

Step 6：運行程序

點擊左上角的按鍵可以運行Python程序，運行時可能會遇到下面的報錯

無法加載文件 E:\Py_Workspace\hello.venv\Scripts\Activate.ps1，因為在此系統(tǒng)上禁止運行腳本

在這里插入圖片描述

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

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

在這里插入圖片描述

4、包管理

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

命令	功能
pip install package_name	安裝一個包
pip install --upgrade package_name	升級一個包
pip uninstall package_name	卸載一個包
pip list	查看已安裝的包
pip show package_name	查看包的詳細信息