uv venv 创建虚拟环境比 python -m venv 快10倍以上,自动探测Python版本、默认带pip,需用 --seed 预装 setuptools/wheel,--clear 可清空旧环境,激活方式与venv完全兼容,且不管理Python版本,仅调用系统已安装的解释器。

直接用 uv venv 就行,比 python -m venv 快 10 倍以上,且默认带 pip、无需额外操作。
安装 uv 后,第一件事就是验证版本
uv 不依赖 Python 环境运行(自带 Rust 运行时),但安装命令需通过系统已有 pip 执行:
-
pip install uv -i https://mirrors.aliyun.com/pypi/simple/(推荐加阿里云镜像) - 装完立刻验证:
uv -V,输出类似uv 0.11.23即成功 - ⚠️ 别用
pipx install uv或从源码编译——二进制安装最稳,CI 场景尤其重要
创建虚拟环境:uv venv 的参数和常见陷阱
核心命令是 uv venv .venv,但它背后有几个关键行为要清楚:
- 默认自动探测当前 shell 使用的 Python 版本(比如你用
pyenv local 3.12,它就读.python-version) - 显式指定版本必须加
--python,例如:uv venv .venv --python 3.12;注意 uv 不自带 Python 解释器,只调用系统已安装的版本 - 默认不预装
setuptools和wheel(pip启动时会自动补,但某些构建脚本或 PyCharm 会报错找不到)→ 加--seed参数解决:uv venv --seed .venv -
--clear很有用:重建前清空旧.venv,避免残留包干扰
激活方式完全兼容 venv,别折腾新语法
uv 创建的环境结构和 python -m venv 一模一样,激活命令照旧:
立即学习“Python免费学习笔记(深入)”;
- Linux/macOS:
source .venv/bin/activate - Windows PowerShell:
.venv\Scripts\Activate.ps1(如提示执行策略受限,先运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser) - Windows CMD:
.venv\Scripts\activate.bat - VS Code 中识别环境:打开项目文件夹后,按
Ctrl+Shift+P→ 输入 “Python: Select Interpreter”,选中.venv下的python.exe即可
为什么不用 uv init?它和环境创建不是一回事
uv init 只生成 pyproject.toml 和 README.md,属于项目元数据初始化,不创建任何虚拟环境。常见误解:
- 运行
uv init后直接uv sync会失败——因为还没uv venv,没地方装包 - 正确流程是:
uv init→ 编辑pyproject.toml写依赖 →uv venv .venv→uv sync(或uv pip install -r requirements.txt) - 如果你只是临时跑个脚本、不需要项目配置,跳过
uv init,直接uv venv .venv+source就够了
真正容易被忽略的是 Python 版本来源:uv 本身不管理 Python 版本,它只调用你系统 PATH 里或 pyenv 指向的那个解释器。想换版本,得先确保目标版本已安装并可用,而不是指望 uv 自带或下载。这点和 conda/pyenv 完全不同,别混用逻辑。


















