'commit'

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

@@ -0,0 +1,127 @@
+## [使用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/'
+```
+