目录

一、写在前面的废话

二、快速使用(我已经了解uv，只想赶紧安装点这里)

1.安装UV

如果有pip:

uv提供独立安装程序:

2.初始化项目

3.添加你需要的包

三、另外

---

一、写在前面的废话

Python项目配置环境这一点毋容置疑地烦人，虚拟环境莫名损坏，依赖安装繁琐，版本冲突等够所有人发吐槽视频了。

没有一个工具能把这些乱七八糟的东西全都管理起来吗？有的兄弟，有的！uv 就是 Python 项目管理的45码大脚

uv由搞出 Ruff 的那个团队 Astral 打造，目标就是让你装包、管理虚拟环境这些事儿变得顺利。uv将会成为你日常 Python 开发中，用来替代 pip 和 pip-tools 甚至 virtualenv 的更快的新工具。你的依赖安装和项目初始化能快到省下时间多摸会鱼。而且它设计上就能和你现在用的工具（比如 pip 和 requirements.txt）无缝切换，这句话的意思是：你完全不用改变现有的工作习惯。

用 uv 干活：

• 你原来怎么写 requirements.txt（例子： numpy==1.26.0），uv也是这个语法

• 你原来用 pip install -r requirements.txt 装包，现在只需把命令开头的 pip 换成 uv（变成 uv pip install -r requirements.txt）

切换回 pip ：

• 如果某天你突然想用回 pip，直接运行原来的 pip 命令(因为 uv 装好的包、生成的虚拟环境，和 pip 完全兼容)，不会搞乱项目。

下面来快速使用uv：

---

二、快速使用(我已经了解uv，只想赶紧安装点这里)

1.安装UV

UV官网（可能需要魔法）

如果有pip:

• 使用pip执行以下命令行

pip install uv

uv提供独立安装程序:

• 如果你的系统是Windows，在powershell执行以下命令行

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

•  macOS and Linux用户在curlsh执行

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

• 或者用curlwget 

wget -qO- https://astral.sh/uv/install.sh | sh

2.初始化项目

uv init -p 加你需要的python版本例如3.13，完成项目的初始化。如果你不关注python版本，直接写uv init也是没毛病的

uv init -p x.xx  指定py版本（x.xx）

uv init  不想管那么多，直接开始

当仅使用uv init时，项目默认python版本为你已经安装的python版本，如果这不是你需要的python版本，在.python-version文件下直接修改是可以的，可直接替换为目标版本

如果你想知道uv支持哪些版本，使用命令uv python list，列出所有uv支持版本。

没有你想用的py版本，使用uv python install cpython3.12 安装某个指定python版本

uv python list  列出所有uv支持版本

uv python install cpython3.12  安装某个指定python版本

3.添加你需要的包

uv add xxx  添加依赖

添加所需要用到的包后，uv会自动创建名叫.nenv的虚拟环境，并且所用到的依赖列表都在toml文件中，方便在其他设备上运行这个项目。

最后：

uv run  运行项目

---

三、另外

toml是完全符合python标准的，可以直接上传部署，在.python-version下更改版本号后，需要uv sync 重新同步，以及还有uv add后面可以加你需要用到的一些工具