## [使用uv管理Python环境的完整指南](https://blog.csdn.net/yuanmomoya/article/details/150006635)



`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$

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



#### $Windows$

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

####  验证安装

```bash
uv --version
```

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

### 三、虚拟环境管理

#### 1. 创建虚拟环境

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

#### 2. 激活虚拟环境

```powershell
.venv\Scripts\activate
```

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

#### 3. $pycharm$中使用$uv$

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

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

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

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

### 四、依赖管理

#### 1. 安装包

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

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

#### 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$国内镜像

```cmd
# 永久修改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/'
```