使用 uv 创建虚拟环境的核心命令是 uv venv,执行后会在当前目录生成一个名为 .venv 的隔离环境。该工具会自动处理 python 解释器的下载与缓存,无需预先在系统中配置全局 python 路径,直接运行即可得到可用的虚拟环境。

如何指定虚拟环境的存放位置
可以通过 -p 参数或环境变量显式指定环境的路径,默认情况下 uv venv 会在当前工作目录下创建 .venv 文件夹。如果希望将环境放置在项目根目录之外的特定路径,只需在命令后追加目标路径即可,例如 uv venv ./my_env 会在当前目录下创建一个名为 my_env 的虚拟环境目录。

uv venv --help # 输出示例: # Create a virtual environment # # Usage: uv venv [OPTIONS] # # Options: # -p, --python <VERSION> Python version to use # --seed Install seed packages # -q, --quiet Do not print any output # -v, --verbose Use verbose output # -h, --help Print help # -V, --version Print version # 实际创建命令 uv venv ./custom_env # 结果:在当前目录下生成 ./custom_env 目录,包含 python 解释器和 pip
如何在创建时自动安装种子包
在创建虚拟环境的同时,可以使用 --seed 标志让 uv 自动安装 pip、setuptools 和 wheel 等基础依赖包。默认情况下,uv venv 创建的纯净环境中可能不包含这些包,启用种子安装可以确保环境具备完整的包管理功能,方便后续直接使用 pip 进行包管理操作。
立即学习“Python免费学习笔记(深入)”;

uv venv --seed # 结果:创建 .venv 并自动安装 pip, setuptools, wheel uv venv --seed ./custom_env # 结果:创建 custom_env 并自动安装基础包 # 验证安装 ./custom_env/bin/python -m pip list # 预期输出: # Package Version # ---------- ------- # pip x.x.x # setuptools x.x.x # wheel x.x.x
基于 uv venv 命令的输出结果确认环境状态
当执行 uv venv 成功后,终端会打印出环境的具体路径,例如 Using Python 3.11.4 environment at /path/to/.venv。这一输出不仅确认了环境的创建位置,还显示了所使用的 Python 版本。开发者可以通过检查该路径下的文件结构来验证环境是否完整,通常包括 bin/(或 Scripts/)目录下的可执行文件和 lib/ 目录下的标准库副本。


















