前情提要
以前寫過從官方網站上下載安裝python的文章,也嘗試過使用當時相對較新的管理工具pipenv。而現在,一切都不同了,使用rust撰寫的套件管理工具uv,執行速度、整合專案開發流程等都是目前首選,終於是有了套完整的方案。安裝uv
可以參考上方的安裝說明,根據電腦作業系統、架構,依喜歡的方式進行安裝。我本機使用的是windows,故以此進行示範。
透過pip
pip install uv
但這麼一來,uv的版本將會交由pip進行管理,而uv是可以管理不同虛擬環境內使用的python版本,可能會產生意外的相容性問題,因此不建議採用。
下載release版本zip
對下指令不熟,習慣透過介面下載實際檔案,可以到github上下載對應的zip檔,解壓縮後將uv.exe加入到path內,環境變數設定完成即可。
透過指令安裝
打開powershell,貼上指令執行,即完成安裝及環境變數的設置
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
指令做的事情會忽略一些安全性政策,從官網執行腳本下載對應本機適合的uv版本,可以看到就是3個執行檔,放入使用者目錄下,腳本幫你建立好的.local
資料夾內,並且處理好環境變數。
- uv.exe
- uvx.exe
- uvw.exe

下方提示要新開一個終端才會生效,或者執行下方的指令,在這個terminal session下指定環境變數設置。
安裝python
目前我的本機是沒有python的狀態,開啟新的終端執行指令,確認有哪些python可以使用。
預設安裝最新的版本(官網最新版為3.13.5),也可以指定安裝特定版本的python。

可以看到完成速度極快,且環境變數也跟著處理了,想確認的話可以下指令
python3.13 --version
建立新專案
建立新的資料夾並切換到裡面,執行指令後便會長出初始的專案架構

專案幫你使用git控管,也加入了需排除的項目到.gitignore
、空白的README.md
,並且使用.toml
檔案管理依賴,裡面紀錄專案相關資訊。

實際執行一下當前程式

在執行後會看到.env
及uv.lock
長出來了,基本上不太需要手動處理這些內容,好奇展開來看,裡面是一大堆常見終端機的shell指令,配合虛擬環境使用的內容。
添加/移除第三方套件依賴
假如我們要使用requests
,也是交由uv下指令進行管理,同時會更新pyproject.toml內的版本資訊。

其中重要的是,第三方套件所依賴的子項目,也會被uv一起追蹤,再刪除的時候一併處理掉,終於不會再有刪不乾淨的問題了。

以上是建立新專案的使用示範,自己在公司內使用幾個月下來,到目前還沒遇到特別奇怪的問題,只能說終於有個較完善的機制,已經回不去以前的使用方式了。