本文详解 UV 工具在 Python 环境管理中的机制，指出 UV 仅管理环境而非安装 Python。涵盖解析器位置、跨平台路径差异、环境创建流程及常见问题解决方案。通过配置 pyproject.toml 或命令行参数可灵活指定 Python 版本，确保项目依赖隔离与路径正确性。
关键概念：UV 是环境管理器，不是 Python 安装器。当你执行 时：
uv venv --python 3.9| 情况 | 操作结果 |
|---|---|
| 已安装 Python 3.9 | 系统检测并创建指向系统解释器的虚拟环境 |
| 未安装 Python 3.9 | 命令执行失败，提示安装方法 |
| 系统 | Python 来源 | 默认安装位置 | UV 环境位置 |
|---|---|---|---|
| Windows | Python.org 安装 | C:\Users\<用户>\AppData\Local\Programs\Python\Python39\ | 项目目录\.venv\Scripts\python.exe |
| macOS | Homebrew 安装 | /usr/local/opt/[email protected]/bin/python3.9 | 项目目录/.venv/bin/python |
| Linux | 系统包管理器 | /usr/bin/python3.9 | 项目目录/.venv/bin/python |
| pyenv 用户 | pyenv 管理 | ~/.pyenv/versions/3.9.x/bin/python | 项目目录/.venv/bin/python |
当执行 uv venv --python 3.9 时，UV 会：
python3.9 可执行文件# 示例命令 uv venv --python 3.9 --path ./myenv
执行后 UV 将：
myenv 文件夹pyvenv.cfgmyenv/
├── bin/ # Unix 系统可执行文件
│ ├── python -> python3.9
│ ├── python3 -> python3.9
│ ├── python3.9 # 实际解析器
│ ├── pip
│ └── ...
├── Scripts/ # Windows 系统可执行文件
│ ├── python.exe -> python3.9.exe
│ ├── python3.9.exe
│ ├── pip.exe
│ └── ...
└── pyvenv.cfg # 环境配置文件
# 查找系统 Python 3.9
where python3.9
C:\Users\John\AppData\Local\Programs\Python\Python39\python.exe
# 创建 UV 环境
uv venv --python 3.9
# 环境路径
tree /F .venv
.venv
├── pyvenv.cfg
└── Scripts
├── python.exe # 指向系统解释器的副本
├── python3.9.exe # 实际解析器
├── pip.exe
└── ...
# 查找系统 Python 3.9
which python3.9
/usr/local/bin/python3.9
# 创建 UV 环境
uv venv --python 3.9
# 环境路径
tree .venv
.venv
├── bin
│ ├── python -> python3.9
│ ├── python3 -> python3.9
│ ├── python3.9
│ ├── pip
│ └── ...
└── pyvenv.cfg
# Windows 安装
choco install python --version=3.9.0
# macOS 安装
brew install [email protected]
# Linux 安装 (Ubuntu/Debian)
sudo apt update
sudo apt install python3.9
# 使用 pyenv 安装
pyenv install 3.9.18
# 指定 Python 解释器路径
uv venv --python /custom/path/to/python3.9
# 验证环境
uv run --python /custom/path/to/python3.9 -c "import sys; print(sys.executable)"
# 创建多个环境
uv venv --python 3.9 --name py39
uv venv --python 3.11 --name py311
# 切换环境
source py39/bin/activate # Linux/macOS
.\\py39\\Scripts\\activate # Windows
uv python list
# 输出示例：
# Available Pythons:
# * /usr/bin/python3.12 (default)
# /usr/local/bin/python3.11
# /home/user/.pyenv/versions/3.9.18/bin/python
# /opt/python/3.8/bin/python3.8
# 设置项目默认 Python
uv use 3.9
# 验证当前环境
uv python --version
# Python 3.9.18
在 pyproject.toml 中配置：
[tool.uv]
python = "3.9" # 固定使用 3.9 版本
这样每次执行 uv venv 都会自动使用 Python 3.9
# 创建测试脚本
echo "import sys; print(sys.executable)" > check_python.py
# 在环境中运行
uv run check_python.py
# 预期输出：
# /home/user/project/.venv/bin/python # Linux/macOS
# C:\project\.venv\Scripts\python.exe # Windows
UV 使用轻量级环境隔离技术：
pyvenv.cfg 配置# pyvenv.cfg 示例
home = /usr/local/bin # 原始 Python 位置
implementation = CPython
version_info = 3.9.18.final.0
include-system-site-packages = false
base-prefix = /usr/local # 基础路径
base-exec-prefix = /usr/local
base-executable = /usr/local/bin/python3.9
.venv 或指定目录最佳实践：
# 1. 安装所需 Python 版本
# 2. 创建 UV 环境
uv venv --python 3.9
# 3. 验证路径
uv run -c "import sys; print(sys.executable)"
通过以上指南，您可以完全掌握 UV 环境中的 Python 解析器位置和行为，避免环境配置中的常见错误。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online