uv：虚拟管理工具

安装uv

1. 在windows powershell 中执行

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

2. 使用 pip 安装

pip install uv

3. 验证安装成功 在cmd中运行

uv --version

​虚拟环境管理

# 在当前目录创建名为 .venv的虚拟环境 
uv venv

# 创建指定 Python 版本的虚拟环境 
uv venv --python 3.12

# 激活虚拟环境
source .venv/bin/activate # Mac/Linux
.venv\Scripts\activate # Windows

管理依赖

# 安装指定的包
uv pip install <包名>

# 根据 requirements.txt文件安装依赖
uv pip install -r requirements.txt

# 列出已安装的包
uv pip list

# 创建 requirements.txt文件
uv pip freeze > requirements.txt

# 卸载包
uv pip uninstall <包名>

在新机器上恢复环境

如没有venv环境，请先执行 uv venv，激活环境后，执行

uv sync

工作流

# 初始化项目，生成 pyproject.toml文件 
uv init

# 添加依赖到 pyproject.toml并安装
uv add <包名>

# 生成或更新锁文件 uv.lock，锁定所有依赖的确切版本
uv lock

# 根据 pyproject.toml和 uv.lock文件同步安装所有依赖
uv sync

运行脚本

运行项目内的脚本​

无需手动执行 source .venv/bin/activate或 .venv\Scripts\activate来激活环境，uv run已经帮你处理好了这一切

uv run <script.py>

运行单文件脚本（无项目结构）​​

uv run --with <包名> <script.py>

# 示例
uv run --with "requests" --with "pandas" my_standalone_script.py

脚本内嵌依赖声明（推荐）

在脚本顶部添加 # /// script注释块。只需运行 uv run my_standalone_script.py，uv便会自动读取注释中的依赖信息并配置好环境。这种方式极大地方便了脚本的分享和协作。

# /// script
# dependencies = [
#     "requests>=2.28",
#     "pandas",
# ]
# ///

import requests
import pandas as pd
# ... 你的代码