建立 python 虛擬環境 in vscode 小記

建立 python 虛擬環境 in vscode 小記

OS: macOS 14.3

vscode: 1.98.2

現在有 Github Copilot / Gemini Code Assist 的幫助, 真的覺得寫 code 的機會真的大幅度的增加

來補一篇在 vscode 裡面建立 python 虛擬環境的方式

以下是常見的 python 虛擬環境建立工具

venv (Python 內建)

• Python 3.3+ 內建模組

• 簡單易用，無需額外安裝

• 適合基本專案需求

• 官方網頁：https://docs.python.org/3/library/venv.html 

virtualenv

• 支援 Python 2.7+ 和 3.x

• 功能較全面，可自定義更多選項

• 需要額外安裝

• 官方網頁：https://virtualenv.pypa.io/ 

conda

• Anaconda/Miniconda 的套件管理工具

• 可同時管理 Python 版本和套件

• 特別適合資料科學和機器學習專案

• 官方網頁：https://docs.conda.io/ 

pipenv

• 結合了 pip 和 virtualenv 的功能

• 自動管理相依性和虛擬環境

• 使用 Pipfile 代替 requirements.txt

• 官方網頁：https://pipenv.pypa.io/ 

poetry

• 現代化的依賴管理和打包工具

• 解決依賴衝突並簡化套件發布

• 提供清晰的依賴聲明和鎖定文件

• 官方網頁：https://python-poetry.org/ 

pyenv

• 主要用於切換多個 Python 版本

• 可與其他虛擬環境工具結合使用

• 官方網頁：https://github.com/pyenv/pyenv  

我使用的是 python 內建的 venv

確認目前使用的 python 版本 可以使用 

% python  --version

Python 3.11.6

確認目前安裝的 python 套件

% pip3  list  

Package                                 Version

--------------------------------------- -----------

aiohappyeyeballs                        2.6.1

aiohttp                                 3.11.13

aiosignal                               1.3.2

接下來進入建立 python 虛擬環境

使用 vscode 方式

• 參考官方文件 https://code.visualstudio.com/docs/python/environments

開啟 Command Palette (⇧⌘P), 搜尋 Python: Create Environment

選取 Python: 建立環境

選取 虛擬環境類型

選取要使用的 python 版本

這個時候應該會自動帶入虛擬環境, 這個時候可以觀察終端幾前面會有 (.venv) 字樣

確認相關資訊

(.venv) max@Max-MacAir aws_all_regions_EC2_instances_total % python3  --version

Python 3.12.7

(.venv) max@Max-MacAir aws_all_regions_EC2_instances_total % pip3  list        

Package Version

------- -------

pip     25.0.1

這個時候就可以觀察到已經在虛擬環境內, 另外資料夾內也會有 .venv 目錄

如果要停用 python 虛擬環境, 可以用以下方式

• 在 vscode 右下角的 python 版本選擇器, 點選非 .venv 的版本, 然後將 .venv 目錄刪除

• 使用指令 deactivate 停用, 然後將 .venv 目錄刪除

如果不使用 vscode 方式建立虛擬環境, 也可以用指令的方式

% python3  -m  venv  venv

• 後面那個 venv 是目錄名稱, 可以按照自己的需求來訂定, 也可以像 vscode 那樣取名為 .venv

• 因為是使用 python3 指令來建立虛擬環境, 所以會用預設的版本來建立虛擬環境, 如果要指定python 版本, 就要使用明確的python 版本來建立, 例如 % python3.12 -m venv venv

啟動虛擬環境

% source  venv/bin/activate

最近會把之前想寫都寫下來

~ enjoy it

References

• https://code.visualstudio.com/docs/python/environments