用 venv 方式建立 Python 虛擬環境

如果你在公司環境或是你在維護舊專案。如果你不想安裝任何新工具。那你一定要會： venv 這是 Python 內建的虛擬環境工具。讓你可以無痛建立獨立虛擬環境，不影響現有電腦，快速進行開發。

Table of Contents

為什麼一定要用虛擬環境？

我給你一個真實場景：

專案 A 用 Django 3
專案 B 用 Django 5

你如果全部裝在同一個 Python 環境，很快的你就會直接瘋掉。

因為每切換一次專案就要再更新一次軟體版本。

虛擬環境的概念其實很簡單：

每個專案都有自己的一個小世界。

venv實際操作教學

Step 1 確認 Python 版本

python3 --version

目前都建議下載 3.9 以上的 Python。

Step 2 建立專案資料夾

mkdir my-project
cd my-project

我們預設要建立的資料夾名稱是 my-project。

Step 3 建立虛擬環境

python3 -m venv my-project-venv

它會產生虛擬環境的資料夾：

my-project-venv/

Step 4 啟動虛擬環境

Mac / Linux：

source my-project-venv/bin/activate

Windows：

my-project-venv\Scripts\activate

如果你在終端機 (CMD & CLI) 看到 (my-project-venv) 就表示成功囉。

Step 5 安裝套件

接下來你可以在這個虛擬環境當中安裝與所需要的套件:

pip install fastapi

Step 6 匯出依賴檔

當你的專案安裝好許多的套件之後

你想將這個虛擬機環境當中的所有套件匯出整理

你可以使用下面的語法產出 requirements.txt 檔案

pip freeze > requirements.txt

未來其他人要重建環境

只要在輸入下面語法就可以把環境給安裝起來：

但我建議一樣先新增一個新的虛擬環境 venv

再輸入下列指令

才不會影響你原來電腦的環境唷！

pip install -r requirements.txt

那我到底該選 venv & uv 哪個？

我會這樣分：

新專案 → 用 uv
公司或舊專案 → 用 venv
團隊需要標準化 → uv 比較舒服

最後想跟你說

真正重要的不是 uv 還是 venv。

而是你有沒有養成這個習慣：

每一個專案，都給它一個獨立環境。

這是工程師成長的分水嶺。

當你開始這樣做，你會發現：

你不是只有在「寫程式」。

你是正在開始學會管理「系統」。