dsProject/Doc/Uv管理环境/使用uv管理Python环境的完整指.md

使用uv管理Python环境的完整指南

uv 是由 Astral 开发的现代 Python 包和虚拟环境管理工具，使用 Rust 编写，兼具高性能与高度兼容性，旨在替代 pip、venv 和部分 virtualenv 的使用场景。

本文将系统介绍如何在 Windows 上使用 uv 管理 Python 环境，包括安装、创建虚拟环境、安装依赖、项目结构管理以及配置国内源（如清华镜像）。

一、uv 简介

uv 的主要功能：

• 快速创建虚拟环境（基于 venv）

• pip 完全兼容的包管理命令：uv pip 相当于 pip

• 支持 pyproject.toml 与 uv.lock 的依赖锁定机制（类似 poetry）

• 内置缓存机制提高安装速度

• 跨平台支持 macOS、Windows、Linux

二、安装 uv

Linux

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

Windows

#动下载 uv 的 Windows 可执行文件（.zip 包），解压后把 uv.exe 放到 C:\Windows\System32 中即可。
https://github.com/astral-sh/uv/releases/latest

验证安装

uv --version

三、虚拟环境管理

1. 创建虚拟环境

cd D:\dsWork\dsProject\dsLightRag
uv venv .venv

2. 激活虚拟环境

.venv\Scripts\activate

3. $pycharm$中使用uv

直接用$uv$创建一个环境就可以使用了，可以在项目目录下看到$.venv$就是$python$的环境了

![(https://dsideal.obs.cn-north-1.myhuaweicloud.com/HuangHai/BlogImages/%7Byear%7D/%7Bmonth%7D/%7Bmd5%7D.%7BextName%7D/20250820085757082.png)

四、依赖管理

1. 安装包

uv pip install uvicorn fastapi starlette "lightrag-hku[api]"

2. 冻结依赖

uv pip freeze > requirements.txt

3. 卸载包

uv pip uninstall requests

4. 生成锁文件（推荐项目使用）

uv init            # 初始化 pyproject.toml
uv add numpy       # 添加依赖
uv lock            # 生成 uv.lock 文件

5. 同步安装

uv sync

6. 配置$PIP$国内镜像

# 永久修改pip源为阿里云镜像源（适用于Windows系统）
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

# 验证是否修改成功
pip config list

global.index-url='https://mirrors.aliyun.com/pypi/simple/'