企业官网建设流程全解析

Why UV？

• 通过pyproject.tomlheuv.lock文件进行项目依赖管理，同时允许开发者在项目中进行不同 python 环境的管理和切换，单一命令实现完整的项目管理，无需pip，venv等其他工具。
• 比pip10 倍以上更加便利快捷的依赖包管理

安装 Installation

Linux 和 MacOS 上的安装命令：

curl-LsSfhttps://astral.sh/uv/install.sh|sh

windows 安装命令：

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

其中，-ExecutionPolicy ByPass用于临时修改 Windows 的安全策略限制，允许在 PowerShell 中执行 psl 脚本。

安装完成之后，默认情况下终端并不了解 uv 的命令补全规则，需要额外让终端在启动时加载 uv 的补全规则：

echo'eval "$(uv generate-shell-completion bash)"'>>~/.bashrc

Windows:

if(!(Test-Path-Path$PROFILE)){New-Item-ItemType File-Path$PROFILE-Force}Add-Content-Path$PROFILE-Value'(& uv generate-shell-completion powershell) | Out-String | Invoke-Expression'

安装完成之后，可以直接运行uv命令，查看 help 内容。

UV 项目开发

项目结构

项目是 uv 的核心概念，通过uv init [your-project-name]可以初始化创建一个项目，初始化的目录结构如下：

. ├── .python-version ├── README.md ├── main.py └── pyproject.toml

例如uv init hello-world：

其中，main.py文件为主入口文件，包含简单的示例代码：

defmain():print("Hello from hello-world!")if__name__=="__main__":main()

uv 通过一个pyproject.toml文件来描述这个 uv 项目，这是 uv 项目的核心文件，包含了这个项目的所有元数据比如项目名称、依赖等内容：

[project] name = "hello-world" version = "0.1.0" description = "Add your description here" readme = "README.md" requires-python = ">=3.13" dependencies = []

通过执行uv run main.py可以执行 python 脚本：

执行之后，项目下会额外生成一个uv.lock锁文件以及.venv/目录：

其中：

• uv.lock是 uv 项目依赖的 python 包的版本信息锁文件，
• .venv/是管理项目的 python 虚拟环境的文件夹，与系统的其他 python 环境相互隔离，uv 可以允许用户在一个项目中进行不同 python 环境的切换。初始化项目之后，默认的 python 环境是 uv 安装时携带的 python 环境，可以通过uv python命令查看当前项目的 python 环境，进行其他版本的 python 环境安装，切换环境等管理操作

初始化完成之后，后续就可以根据具体项目需求，使用 flask 等后台代码框架进行应用代码的初始化和开发了。

依赖包管理

uv 安装依赖包的方式如下

uvadd[package]uv pipinstallflask

可以使用与 pip 一样的方式使用==, >=, <=指定版本，或者版本条件安装进行安装：

uv pipinstall'ruff>=0.2.0'

一些依赖包设置了额外的依赖选项，需要通过package[option]的方式指定依赖项安装：

uv pipinstall"flask[dotenv]"

Python 环境管理

uv 项目中，一般通过uv venv创建虚拟环境（类似 conda）：

uv venv--python3.12

使用uv python命令进行 python 环境管理：

# 常用，安装指定版本uv pythoninstall[version]uv pythoninstall3.12# 根据项目要求安装满足条件的版本uv pythoninstall'>=3.8,<3.10'# 安装多版本uv pythoninstall3.93.103.11

UV 项目构建和发布

通过build命令进行项目的构建，uv 可以支持构建whleel分发包（.whl）以及源码分发包--sdist（.tar.gz）两种形式：

uv build--wheel# --sdist

运行完成之后，将会在项目根目录下面生成build/和dist/两个文件夹，dist文件夹下面即包含了构建完成的可发布的结果。