uv Windows配置

不明觉厉二十年2026-07-31 18:22

UV使用记录

uv 本身使用请参考官方文档

https://uv.doczh.com/

Windows安装

官方脚本安装

bash 复制代码

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

二进制安装

https://github.com/astral-sh/uv/tags

建议放在官方脚本默认目录下

bash 复制代码

 C:\Users\XXX\.local\bin
 D:\Users\XXX\.local\bin

加入环境变量

bash 复制代码

 uv python update-shell

配置镜像加速下载

bash 复制代码

D:\Users\xxx\AppData\Roaming\uv\uv.toml
D:\Users\xxx\AppData\Roaming\uv\uv.toml

uv.toml文件内容

bash 复制代码

python-install-mirror = "https://registry.npmmirror.com/-/binary/python-build-standalone/"
[[index]]
url = "https://mirrors.ustc.edu.cn/pypi/simple"
default = true

安装cmd窗口默认直接可以用的python （不推荐，还有修改site.py里的变量才能搭配pip使用）

python

bash 复制代码

D:\Users\xxx\AppData\Roaming\uv>uv python install 3.14 --default
warning: The `--default` option is experimental and may change without warning. Pass `--preview-features python-install-default` to disable this warning
Python 3.14 is already installed

D:\Users\xxx\AppData\Roaming\uv> python --version
Python 3.14.6

pip

bash 复制代码

D:\Users\xxx\AppData\Roaming\uv>uv tool install pip --python 3.14
`pip` is already installed

D:\Users\xxx\AppData\Roaming\uv>pip list
Package Version
------- -------
cowsay  6.1
pip     26.1.2

至此全局python和pip已经安装完成，可以像用安装包安装的python一样使用

uv conda风格

uv可以方便的创建虚拟环境

bash 复制代码

D:\Users\xxx\tmp>uv venv env_test --python 3.15
Using CPython 3.15.0b4 interpreter at: D:\Users\xxx\AppData\Roaming\uv\python\cpython-3.15-windows-x86_64-none\python.exe
Creating virtual environment at: env_test
Activate with: env_test\Scripts\activate

在Windows终端里新加一个配置文件；

bash 复制代码

%WINDIR%\System32\cmd.exe "/K" D:\Users\xxx\tmp\env_test\Scripts\activate.bat  D:\Users\xxx