快速方便的Python包管理工具
UV安装及在 PyCharm 使用
本教程基于windows
介绍
uv是一个极速的Python包管理器
支持：
- 依赖声明（
pyproject.toml） - 精确锁定（
uv.lock） - 虚拟环境管理（
.venv） - 与现代 Python 标准（PEP 621）完全兼容
一句话来说就是方便的与你的团队进行包管理，个人使用也非常方便
安装
使用url
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
使用 pip 安装:
如果您已经安装了 Python 和 pip，可以通过以下命令直接安装 uv：
pip install uv
pipx install uv
验证
uv --version
# 应输出类似：uv 0.8.22
配置缓存目录
uv缓存默认c盘，你可以通过 环境变量 ** 来更改缓存（建议，缓存还是比较大的）
$env:UV_CACHE_DIR = "D:\.uv_cache"
创建项目
pycharm自2024已经支持通过uv创建虚拟环境，这使得我们不必通过终端新建项目:
- 打开pycharm
- 在自定义环境中选择uv，Python版本自行选择
会自动创建pyproject.toml文件
使用UV
以langchain包为例
# 添加生产依赖
uv add langchain
| 添加生产依赖 | uv add requests |
|---|---|
| 添加开发依赖 | uv add --dev pytest |
| 安装所有依赖 | uv sync （通常不需要， uv add 已自动安装） |
| 运行脚本 | uv run python main.py |
| 查看已安装包 | uv pip list |
| 升级所有依赖 | uv lock --upgrade && uv sync |
| 指定 Python 版本创建环境 | uv venv --python 3.11 |
Git 提交建议
提交：
pyproject.tomluv.lock
忽略（.gitignore）：
gitignore
.venv/
__pycache__/
*.pyc
.env
注意
尽量不要混用pip，如果不小心点了pycharm提示的安装某个包(默认pip)，可删除再用uv
卸载
- 清理存储的数据（可选）：
uv cache clean
rm -r "$(uv python dir)"
rm -r "$(uv tool dir)"
在删除二进制文件前，您可能需要先移除 uv 存储的所有数据。 2. 删除 uv 和 uvx 二进制文件：
$ rm $HOME\.local\bin\uv.exe
$ rm $HOME\.local\bin\uvx.exe