快捷導航

Python新手入門指南之如何極速搭建開發(fā)環(huán)境

更新時間：2025年06月10日 10:52:11 作者：廣龍宇

Python在軟件開發(fā)領(lǐng)域占據(jù)重要地位,廣泛應(yīng)用于Web開發(fā),數(shù)據(jù)分析,人工智能及自動化腳本等領(lǐng)域,本文我們就來看看如何快速搭建Python開發(fā)環(huán)境吧

引言

Python在軟件開發(fā)領(lǐng)域占據(jù)重要地位，廣泛應(yīng)用于Web開發(fā)、數(shù)據(jù)分析、人工智能及自動化腳本等領(lǐng)域。其簡潔的語法和豐富的庫支持使其成為開發(fā)者的首選語言之一，尤其在快速原型開發(fā)和跨平臺項目中表現(xiàn)突出。

開發(fā)環(huán)境搭建是高效編程的基礎(chǔ)，直接影響代碼質(zhì)量、調(diào)試效率和協(xié)作流程。合適的工具鏈（如IDE、版本控制和依賴管理）能顯著降低學習成本，確保項目從開發(fā)到部署的順暢過渡。

想我在入門python開發(fā)的時候，遇到一堆坑，“python版本不匹配”，“代碼縮進出問題”，“中英文符號分不清”，光搭建開發(fā)環(huán)境就遇到過很多問題，比如安裝了3.12再安裝其他版本又占空間，還容易出問題，還得修改環(huán)境變量，不過，雖然坑多，但python確實好用，才讓我這幾年不放棄。

本文內(nèi)容面向初學者和中級開發(fā)者，旨在提供清晰的實踐指導。由于本人是極端偏向于新技術(shù)的人，在本文中將不再介紹過氣的直接安裝python，也不會講conda體系復雜的虛擬環(huán)境安裝，而是直接使用新一代工具uv來快速搭建python開發(fā)環(huán)境，無論是希望系統(tǒng)學習Python的新手，還是需優(yōu)化開發(fā)環(huán)境的經(jīng)驗者，均可從實用建議中受益。

為什么選擇uv?

因為這個工具可以管理python版本，可以作為包管理工具，同時最主要的是可以不用關(guān)注pip換源了，安裝包的速度是之前pip的好幾倍（基本上秒完成），除此以外占用空間小，項目成體系，簡直是python開發(fā)的神器。

基礎(chǔ)環(huán)境搭建

1. Windows環(huán)境搭建

在Windows下使用uv搭建環(huán)境非常簡單，僅需要打開powershell，運行以下命令即可

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

運行完成后，執(zhí)行uv -V，不報錯就是安裝成功了

2. Mac和Linux系統(tǒng)搭建

在Mac和Linux系統(tǒng)下安裝uv也是十分容易，基本上僅需一條命令

curl -LsSf https://astral.sh/uv/install.sh | sh

需要注意的是，如果你報錯了，請安裝curl工具，盡管這個工具一般系統(tǒng)都是自帶的，但是任然存在部分精簡系統(tǒng)沒有這個工具。

驗證是否安裝成功的方法參考1. Windows環(huán)境搭建。

3. 安裝代碼編輯工具

代碼編輯工具無腦推VSCode，當然PyCharm也是非常好用的，但是實際上VSCode更加輕量級，新手入門主要是關(guān)注代碼就行，而且免費。安裝vscode僅需一行命令

winget install Microsoft.VisualStudioCode

安裝完成后打開vscode僅需安裝一個Python Extension Pack插件就可以開始編程了。

uv工具的基本用法

官方給出了uv工具基本用法, 如下

uv init example
cd example
uv add ruff
uv run ruff check
uv lock
uv sync

接下來我將挨個介紹這幾個命令

1. 初始化項目

uv創(chuàng)建一個新的項目非常簡單粗暴，僅需要創(chuàng)建一個目錄，然后進去執(zhí)行

uv init

或者不創(chuàng)建文件夾也行，直接運行

uv init example

其中example就是給你創(chuàng)建的項目文件夾。（沒錯，這就完事了）

2. 添加依賴

添加依賴也是只有一條命令，非常好記，就是add，比如安裝ruff代碼檢查工具

uv add ruff

運行效果大概是下面這樣

基本上秒完成，非?？?，不用換源，建議python開發(fā)者都換到uv上來。

3. 代碼檢查

代碼檢查本質(zhì)上是不太需要的，畢竟python沒有那么嚴格，但是為了保證你寫的代碼的正確性，建議檢查代碼。這部分內(nèi)容的基于上面安裝的ruff的，安裝了這個包才可以進行代碼檢查。直接執(zhí)行以下命令

uv run ruff check

如果你的代碼沒有問題，則會顯示以下效果

否則就會提示你哪里語法有問題需要修改，直接幫新手完成了語法檢查的步驟。

4. 鎖定依賴

鎖定依賴沒有什么說的，其實就是將你的依賴鎖定了，以后安裝就只安裝這個版本的依賴，以防依賴更新了你的程序就跑不起來了，直接執(zhí)行下面的語句即可。

uv lock

5. 更新依賴

更新依賴，見名知意，就是更新你項目的依賴，如果你進行了依賴改動(手動)，那么就需要更新依賴，也是一條命令

uv sync

6. 運行代碼

基本的運行代碼很簡單，只要用run加腳本名就可以了，至于更復雜的可以去官方文檔研究研究，現(xiàn)在的mcp基本上都是用的uv來做的，就是因為其運行代碼很方便，也是一條命令

uv run main.py

uv的高級用法

1. 虛擬環(huán)境管理 (Virtual Environments)

uv 提供高效的虛擬環(huán)境管理功能，支持多種高級配置：

創(chuàng)建虛擬環(huán)境

# 創(chuàng)建默認虛擬環(huán)境
uv venv .venv

# 指定 Python 版本 
uv venv --python 3.11 .venv

環(huán)境激活

# Unix 系統(tǒng)
source .venv/bin/activate

# Windows 系統(tǒng)
.\.venv\Scripts\activate

環(huán)境管理

uv python install: 安裝python版本

uv python list: 查看可用的python版本

uv python find: 查找一個已安裝的python版本

uv python pin: 將當前項目固定使用特定的Python版本。

uv python uninstall: 卸載一個python版本

高級特性

輕量級環(huán)境：比傳統(tǒng) virtualenv 快 10 倍
跨平臺兼容：Windows/macOS/Linux 一致體驗
環(huán)境繼承：--system-site-packages 復用系統(tǒng)包
符號鏈接：--symlinks 減少磁盤占用

2. 腳本管理 (Scripts)

uv 支持在 pyproject.toml 中定義和管理項目腳本：

定義腳本

# pyproject.toml
[tool.uv.scripts]
# 簡單命令
start = "python main.py"
test = "pytest -v"

# 多命令序列
deploy = [
    "uv pip compile requirements.in -o requirements.txt",
    "uv pip sync requirements.txt",
    "gunicorn app:app"
]

# 帶環(huán)境變量
migrate = { cmd = "alembic upgrade head", env = { "DB_URL" = "postgres://user:pass@localhost/db" }}

# 平臺特定命令
serve = { windows = "waitress-serve --port=8000 app:app", unix = "gunicorn app:app" }

運行腳本

# 運行單個腳本
uv run start

# 帶參數(shù)傳遞
uv run test -- -x  # 傳遞給 pytest: pytest -v -x

# 運行多命令腳本
uv run deploy

# 預定義鉤子
uv run pre-commit  # 自動運行 pre-commit 鉤子

高級特性