快捷導(dǎo)航

如何使用uv構(gòu)建Python包并本地安裝步驟詳解

更新時(shí)間：2025年06月06日 10:05:13 作者：夢(mèng)想畫(huà)家

uv是一個(gè)由Astral開(kāi)發(fā)的超快Python包安裝工具和解析器,使用Rust編寫(xiě),旨在替代pip、pip-tools和virtualenv,提供更快的性能和更好的依賴(lài)管理,這篇文章主要介紹了如何使用uv構(gòu)建Python包并本地安裝的相關(guān)資料,需要的朋友可以參考下

前言

本文將逐步指導(dǎo)你創(chuàng)建一個(gè)簡(jiǎn)單的 Python 包，并將其本地安裝到機(jī)器或云環(huán)境中。完成本教程后，你將擁有一個(gè)可復(fù)用的 Python 庫(kù)，可直接通過(guò) pip 安裝或在項(xiàng)目中導(dǎo)入使用。

步驟詳解

Step 0: 選擇構(gòu)建工具 - 使用 uv

推薦理由：uv 是類(lèi)似 poetry 的現(xiàn)代打包工具，默認(rèn)使用 hatchling 作為構(gòu)建后端，支持 PEP 517/518 標(biāo)準(zhǔn)。

安裝方法：

# 通過(guò) Homebrew 安裝（MacOS）
brew install uv
# 或直接通過(guò) PyPI
pip install uv

Step 1: 創(chuàng)建包目錄結(jié)構(gòu)

使用 uv 快速初始化項(xiàng)目結(jié)構(gòu)：

uv init --lib my-package

生成后的目錄如下：

my_package/
├── src/
│   └── my_package/
│       ├── __init__.py       # 標(biāo)記為 Python 包
│       └── your_code.py      # 存放核心代碼
│       └── py.typed          # 類(lèi)型標(biāo)注聲明（可選）
├── pyproject.toml          # 項(xiàng)目元數(shù)據(jù)和依賴(lài)配置
├── README.md               # 項(xiàng)目文檔
└── .python-version         # 指定 Python 版本

Step 2: 編寫(xiě)包代碼

在 src/my_package/your_code.py 中添加功能代碼：

# my_package/your_code.py
def greet(name: str) -> str:
    """返回問(wèn)候語(yǔ)"""
    return f"Hello, {name}!"

Step 3: 配置 pyproject.toml

填寫(xiě)項(xiàng)目元數(shù)據(jù)和依賴(lài)項(xiàng)：

[project]
name = "my-package"
version = "0.1.0"
description = "一個(gè)簡(jiǎn)單的本地 Python 包示例"
readme = "README.md"
authors = [{ name = "Sarah Glasmacher", email = "sarah@example.com" }]
requires-python = ">=3.11"
dependencies = []

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

Step 4: 構(gòu)建分發(fā)包

運(yùn)行以下命令生成 .whl 或 .tar.gz 文件：

uv build

構(gòu)建完成后，dist/ 目錄下會(huì)生成類(lèi)似以下的文件：

dist/
├── my_package-0.1.0-py3-none-any.whl
└── my_package-0.1.0.tar.gz

Step 5: 本地安裝包

方法 1：直接安裝構(gòu)建產(chǎn)物

pip install dist/my_package-0.1.0-py3-none-any.whl

方法 2：以編輯模式安裝（實(shí)時(shí)同步代碼）

pip install -e .

Step 6: 測(cè)試安裝

打開(kāi) Python 終端驗(yàn)證：

from my_package.your_code import greet
print(greet("World"))  # 輸出：Hello, World!

關(guān)鍵注意事項(xiàng)

模塊化設(shè)計(jì)：將代碼按功能拆分為獨(dú)立模塊，便于維護(hù)和復(fù)用。
依賴(lài)管理：通過(guò) dependencies 字段聲明依賴(lài)，或使用 uv add <package> 自動(dòng)更新 pyproject.toml。
版本控制：每次發(fā)布新版本前更新 version 字段，避免沖突。

擴(kuò)展應(yīng)用場(chǎng)景

云部署：將打包后的代碼上傳至 Databricks 或 AWS Lambda，直接調(diào)用云端計(jì)算資源。
協(xié)作開(kāi)發(fā)：通過(guò) PyPI 發(fā)布包（需額外配置），團(tuán)隊(duì)成員可直接 pip install 同步代碼。

通過(guò)本文，你已掌握 Python 包的基礎(chǔ)構(gòu)建和本地安裝流程。下一階段可嘗試將包發(fā)布到 PyPI，實(shí)現(xiàn)全球范圍內(nèi)的代碼共享！