python安装、使用uv

###参考:

https://uv.doczh.com/

###安装:

下载:

https://github.com/astral-sh/uv/releases/latest/download/uv-x86_64-pc-windows-msvc.zip

解压,把里面的 uv.exe 直接放到你想要的目录,例如:

把目录加到系统 PATH :

###升级uv

uv self update

###卸载uv

uv cache clean

rm -r "$(uv python dir)"

rm -r "$(uv tool dir)"

删除3个exe文件

###验证

uv --version

uv help

###设置国内镜像源

macOS/Linux: ~/.config/uv/uv.toml;

Windows: %APPDATA%\uv\uv.toml;

若不存在,请手动创建 uv 文件夹和 uv.toml 文件;

bash 复制代码
# CPython 解释器下载加速(必须放在 [[index]] 上方)
python-install-mirror = "https://cnb.cool/astral-sh/python-build-standalone/-/releases/download/"
# PyPI 国内镜像源(可配置多个)
[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true
[[index]]
url = "https://mirrors.cloud.tencent.com/pypi/simple"
[[index]]
url = "https://mirrors.aliyun.com/pypi/simple"
[[index]]
url = "https://repo.huaweicloud.com/repository/pypi/simple"

###安装/指定python版本

安装特定版本的 Python:uv python install 3.12

查看可用和已安装的 Python 版本:uv python list

即使未请求特定的 Python 版本,uv 也会按需下载最新版本。例如,如果系统上没有任何 Python 版本,以下命令将在创建新的虚拟环境之前安装 Python: $ uv venv

设置全局默认 Python 版本: uv python default 3.12

为当前项目固定 Python 版本(会在当前项目下创建 .python-version 文件,内容: 3.12): uv python pin 3.12

###项目管理(推荐方式)

uv 支持以 pyproject.toml 为中心的现代项目管理方式,这是比 pip 模式更推荐的使用方法,尤其适合团队协作和多环境部署。

##初始化项目,方式1:

uv init my_project

cd my_project

##初始化项目,方式:2:

mkdir my_project

cd my_project

uv init

这会创建以下基本项目结构:

my_project/

├── pyproject.toml # 项目配置和依赖声明

├── .python-version # 固定 Python 版本

├── README.md

└── main.py

##添加和移除依赖

在项目模式下,推荐使用 uv add 和 uv remove 管理依赖,它们会自动更新 pyproject.toml 和 uv.lock:

添加生产依赖:uv add requests

添加指定版本的依赖:uv add "requests>=2.31.0"

添加开发依赖(只在开发环境使用,如测试框架):uv add --dev pytest ruff

移除依赖:uv remove requests

根据 pyproject.toml 和 uv.lock 一键安装所有依赖: uv sync

解析 pyproject.toml 中的依赖,生成/更新uv.lock 文件:uv lock

禁用自动下载 Python 默认情况下,uv 会在需要时自动下载 Python 版本。 可以使用python-downloads选项来禁用此行为。默认设置为automatic;设置为manual则仅在uv python install期间允许下载 Python。 Tip 可以在持久配置文件中设置python-downloads,以更改默认行为,或者可以将--no-python-downloads标志传递给任何 uv 命令。

相关推荐
CG_MAGIC6 天前
3ds Max材质编辑器:精简模式与Slate模式对比
3d·编辑器·材质·贴图·uv·建模教程
玉夏6 天前
【Shader基础】UV 与纹理采样 Part1
unity·着色器·uv
codeaideaai7 天前
使用UV创建python项目
python·fastapi·uv
milo.qu7 天前
Python工程工具链:uv + 虚拟环境
uv
砍材农夫8 天前
python环境|pip|uv|venv|Conda区别
后端·python·conda·pip·uv
jingqiulyue9 天前
uv sync 找不到uv怎么办
uv
love530love9 天前
2026年终极防坑指南:基于 EPGF 架构彻底“本地化” UV 环境与工具
人工智能·windows·python·架构·devops·uv·epgf
砍材农夫10 天前
python 如何一次性安装项目所有依赖包(pip和uv)
开发语言·python·pip·uv
文创工作室11 天前
三维模型展UV软件 RizomUV Virtual Space 2022.0.11 中文汉化
uv·rizomuv
SHIPKING39312 天前
【UV】从入门到实战
uv