128 lines
3.2 KiB
Markdown
128 lines
3.2 KiB
Markdown
## [使用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
|
||
```
|
||
|
||
|
||
|
||
### 三、虚拟环境管理
|
||
|
||
#### 1. 创建虚拟环境
|
||
|
||
```bash
|
||
cd D:\dsWork\dsProject\dsLightRag
|
||
uv venv .venv
|
||
```
|
||
|
||
#### 2. 激活虚拟环境
|
||
|
||
```powershell
|
||
.venv\Scripts\activate
|
||
```
|
||
|
||
|
||
|
||
#### 3. $pycharm$中使用$uv$
|
||
|
||
直接用$uv$创建一个环境就可以使用了，可以在项目目录下看到$.venv$就是$python$的环境了
|
||
|
||
|
||
|
||
|
||
|
||
### 四、依赖管理
|
||
|
||
#### 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$国内镜像
|
||
|
||
```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/'
|
||
```
|
||
|