UV安装Python指南总结

UV安装Python指南总结

UV是一个Python包管理工具,它可以帮助我们安装和管理Python版本。以下是关于UV安装Python的主要功能和用法总结。

基本使用

安装最新版Python

uv python install

注意：UV使用Astral的python-build-standalone项目提供的Python发行版,而不是官方发行版。

安装特定版本

# 安装单个版本
uv python install 3.12# 安装多个版本
uv python install 3.11 3.12# 安装PyPy实现
uv python install pypy@3.10

重要特性

1. 自动下载

   • UV会根据需要自动下载所需的Python版本
   • 可以通过配置禁用自动下载功能
   • 例如: uvx python@3.12 -c "print('hello world')" 会自动下载Python 3.12

2. 查看已安装版本

   uv python list
   

3. 重新安装Python

   uv python install --reinstall
   

4. 升级Python版本

   # 升级特定版本到最新补丁版本
   uv python upgrade 3.12# 升级所有UV管理的Python版本
   uv python upgrade
   

重要说明

1. UV安装的Python版本默认不会全局可用(即通过python命令)，该功能目前处于预览状态。

2. 可以通过以下方式使用已安装的Python:

   • 使用uv run命令
   • 创建并激活虚拟环境

3. UV会自动检测并使用系统已安装的Python版本,无需额外配置

   • 使用--no-managed-python标志可强制使用系统Python

注意事项

• 升级Python补丁版本的功能仍处于预览状态
• UV会优先使用满足要求的系统Python版本
• 重新安装可能会解决bug,即使Python版本没有变化

官方文档