1.Windows安装
1.1 pip安装
pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple
如果需要centos安装pip
sudo yum install python3-pip
CentOS 8开始使用dnf
作为包管理器:
sudo dnf install python3-pip
对于基于Debian的系统(如Ubuntu)
sudo apt-get update
sudo apt-get install python3-pip
1.2 PowerShell脚本安装
打开PowerShell,执行:
irm https://astral.sh/uv/install.ps1 | iex
1.3 使用Pipx(适合全局工具管理)
若已安装pipx
:
pipx install uv
2.uv安装python环境
安装指定的python版本
uv python install 3.12
安装多个python版本
uv python install 3.11 3.12
3.uv使用python
初始化添加备注
uv init --script F:\gitee\spider\test\test3.py --python 3.10
1.创建虚拟环境
$ uv venv --python 3.10
Using CPython 3.10.5 interpreter at: C:\Program Files\Python310\python.exe
Creating virtual environment at: .venv
Activate with: source .venv/Scripts/activate
PC@DESKTOP-5SR7P58 MINGW64 ~/Desktop
$ source .venv/Scripts/activate
(Desktop)
PC@DESKTOP-5SR7P58 MINGW64 ~/Desktop
$ python --version
Python 3.10.5
2. 使用不同python版本
# 查看已安装的python版本
uv python list
启用python
uv python pin 版本号
PC@DESKTOP-5SR7P58 MINGW64 /f/gitee/spider/test/uv_test (master)
$ uv python list
cpython-3.14.0a6-windows-x86_64-none <download available>
cpython-3.14.0a6+freethreaded-windows-x86_64-none <download available>
cpython-3.13.3-windows-x86_64-none <download available>
cpython-3.13.3+freethreaded-windows-x86_64-none <download available>
cpython-3.12.10-windows-x86_64-none <download available>
cpython-3.11.12-windows-x86_64-none <download available>
cpython-3.11.3-windows-x86_64-none C:\ProgramData\anaconda3\python.exe
cpython-3.10.17-windows-x86_64-none <download available>
cpython-3.10.5-windows-x86_64-none C:\Program Files\Python310\python.exe
cpython-3.9.22-windows-x86_64-none <download available>
cpython-3.8.20-windows-x86_64-none <download available>
pypy-3.11.11-windows-x86_64-none <download available>
pypy-3.10.16-windows-x86_64-none <download available>
pypy-3.9.19-windows-x86_64-none <download available>
pypy-3.8.16-windows-x86_64-none <download available>
graalpy-3.11.0-windows-x86_64-none <download available>
graalpy-3.10.0-windows-x86_64-none <download available>PC@DESKTOP-5SR7P58 MINGW64 /f/gitee/spider/test/uv_test (master)
$ uv python pin cpython-3.10.5-windows-x86_64-none
Pinned `.python-version` to `cpython-3.10.5-windows-x86_64-none`PC@DESKTOP-5SR7P58 MINGW64 /f/gitee/spider/test/uv_test (master)
$ cat .python-version
cpython-3.10.5-windows-x86_64-none
3.初始化项目
方式一:
uv init
# 初始化完成之后可以看到如下文件
$ ls
main.py pyproject.toml README.md
方式二:
直接制定项目名称
uv init 项目名称
注: 如果需要指定特定python版本,建议使用第一种方式来创建项目,否则还需要手动修改pyproject.toml配置文件里面需要的python版本。
4.安装依赖
uv add requests
# 设置镜像源
uv add --default-index https://pypi.tuna.tsinghua.edu.cn/simple requests
uv也提供了全局的配置项,可以通过环境变量UV_DEFAULT_INDEX
配置镜像源
export UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple
uv下载第三方库本质上也是通过pypi源下载的,所以在国内网络环境中默认链接速度会很慢,可以在项目目录的pyproject.toml中添加如下内容来使用清华源
[[tool.uv.index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true
全局的配置项优先级低于pyproject.toml中配置的镜像源。如果pyproject.toml里面配置了镜像源,则会使用pyproject.toml的配置。