uv的用法一：创建uv项目

1、安装uv

首先如果没有安装uv的话，直接在base环境下安装uv：

pip install uv

2、查看可用的python版本

可以使用命令查看当前可用的python版本

uv python list

使用如下命令创建名为Demo的项目并指定python的版本为3.10.12：

uv init Demo -p 3.10.12

这个命令会在当前目录下创建一个项目名为Demo的文件夹，并在这个文件夹里面自动生成三个文件——main.py、pyprojecy.toml、README.md

：如果某个项目要求的python版本环境在python list中没有列出来，那么就需要自己去安装对应版本的Cpython，这里以3.11.3版本为例，步骤如下：

1、登录Index of /ftp/python/3.11.3/，下载Python-3.11.3.tgz到本地。（链接——https://www.python.org/ftp/python/3.13.5/Python-3.11.3.tgz
）

2、手动编译安装：

tar -xzf Python-3.11.3.tgz
cd Python-3.11.3
./configure --prefix=$HOME/.local/python-3.11.3
make -j$(nproc)
make install

3、把手动安装的目录加到path里（因为uv python list会去扫描系统path里的可执行 Python）

echo 'export PATH="$HOME/.local/python-3.11.3/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

4、最后再执行uv python list即可看到新下载的cpython-3.11.3：

3、换镜像源

cd进入项目文件夹，然后打开pyprojecy.toml文件，在最后添加如下代码，实现针对项目内换源：

[tool.uv]
index-url="https://mirrors.aliyun.com/pypi/simple"

4、创建uv项目和虚拟环境

然后就可以使用如下命令安装相关项目依赖（如gradio库），不需要切换进虚拟环境，因为这个命令会自动创建.venv的虚拟环境，会自动把这个库安装到当前项目里面的虚拟环境.venv文件夹当中：

uv add gradio

5、在Pycharm中打开uv项目

直接在pycharm中打开Demo这个项目文件夹，不需要指定解释器和环境，系统会自动识别当前这个项目文件夹里面的uv虚拟环境（VsCode也同理）：

 参考：UV的简单使用以及使用pycharm打开项目_pycharm uv-CSDN博客

https://zhuanlan.zhihu.com/p/1908630076704159010

uv的用法二：把uv当作pip加速的工具

可以参考我的文章的第二节安装项目环境：

端侧智能体开发-CSDN博客

适用于当用法三无法创建环境时，可以采用方法二：

1、直接创建指定python的虚拟环境rag：

uv venv rag --python 3.11.3

2、激活环境：

source rag/bin/activate

3、直接用uv下载requirements里的项目依赖包：

uv pip install -r requirements.txt

会把所有的包都下载到rag虚拟环境当中。

最后直接在pycharm中打开这个项目文件夹，也是不需要指定解释器和环境，系统会自动识别当前这个项目文件夹里面的uv虚拟环境rag（VsCode也同理）：

uv的用法三：已有uv项目代码，创建该项目的环境

uv项目已经存在pyproject.toml、README.md 等文件

1、手动创建虚拟环境

先根据系统可用python版本去创建指定python版本的虚拟环境如 edge_agent ：

uv venv edge_agent --python 3.10.12

更新：上述方法错误，直接cd进入项目目录，然后第二步也没有，直接进入第三步。 

cd UMoodBuddy

 自动创建的虚拟环境名字为.venv，因为如果自己创建环境的话，使用同步下载目录无法下载到指定的环境当中。

2、激活虚拟环境：

# 激活环境
source edge-agent/bin/activate  # macOS/Linux

 3、同步该uv项目的的python依赖包：

uv sync --python3.10 --all-extras

sync：同步（下载）命令

--python3.10：确保指定使用Python3.10版本来安装依赖

--all-extras：安装pyproject.toml或setup.py的所有可选依赖（extras）

至此环境创建完成！