1、windows下安装uv
bash
winget install uv
安装成功后重启终端,输入命令验证:
bash
uv --version
2、uv安装python
查看可用的python版本
bash
uv python list
2.1安装特定版本
bash
uv python install 3.11.6
3、管理虚拟环境
3.1 创建
bash
# 在当前目录创建名为 .venv 的虚拟环境(使用系统默认 Python)
uv venv
# 使用指定 Python 版本创建虚拟环境
uv venv --python 3.12
3.2 激活
bash
# Windows(PowerShell)
.venv\Scripts\activate
3.3 退出
bash
deactivate
4、初始化项目
没有添加项目名,默认就是你打开的文件夹
bash
uv init [项目名可选]
5、添加和移除依赖
5.1、添加
bash
# 添加生产依赖
uv add requests
# 添加指定版本的依赖
uv add "requests>=2.31.0"
# 它会根据 pyproject.toml 和 uv.lock 安装所有依赖
uv sync
5.2、移除
bash
# 移除依赖
uv remove requests
6、生成/更新锁文件
解析 pyproject.toml 中的依赖并生成(或更新)uv.lock 文件
bash
uv lock
7、uv环境变量配置
- UV_PYTHON_INSTALL_DIR: 指定 Python 解释器的安装目录。
- UV_CACHE_DIR: 指定缓存目录。
8、配置镜像源
Windows: %APPDATA%\uv\uv.toml (例如 C:\Users\你的用户名\AppData\Roaming\uv\uv.toml)
如果文件或目录不存在,需要手动创建。
在 uv.toml 文件中添加以下内容:
bash
index-url = "https://pypi.tuna.tsinghua.edu.cn/simple"
9、pycharm中配置uv
在path to uv输入uv安装的目录

9.1 windows查找uv安装目录
bash
where uv