使用 uv 命令创建 Python 虚拟环境非常简单。以下是具体步骤和常用命令:
基本命令
-
创建虚拟环境:
uv venv这会在当前目录下创建一个名为
.venv的虚拟环境。如果想自定义虚拟环境目录名,可以指定:uv venv my_env -
指定 Python 版本: 如果需要使用特定的 Python 版本,可以通过
--python参数指定:uv venv --python 3.12例如,上述命令会使用 Python 3.12 创建虚拟环境。如果系统中没有指定版本,
uv会尝试下载对应的 Python 版本。 -
激活虚拟环境:
- 在 Linux/macOS 上:
source .venv/bin/activate - 在 Windows 上:
.venv\Scripts\activate
- 在 Linux/macOS 上:
-
验证虚拟环境: 激活虚拟环境后,可以检查 Python 解释器路径以确认:
which python如果路径指向
.venv/bin/python(Linux/macOS)或.venv\Scripts\python(Windows),则说明虚拟环境已正确激活。
高级用法
-
自动创建虚拟环境: 如果你在项目中运行
uv add或uv run等命令,uv会在项目根目录自动创建.venv虚拟环境(如果不存在)。 -
跨平台虚拟环境管理: 如果在 Windows 和 Linux 之间共享项目(如通过 WSL),可以为不同平台设置不同的虚拟环境目录。例如,使用环境变量
UV_PROJECT_ENVIRONMENT指定虚拟环境路径:export UV_PROJECT_ENVIRONMENT=.venv_linux -
删除虚拟环境: 要删除虚拟环境,只需删除虚拟环境目录:
rm -rf .venv
注意事项
-
安装 uv:确保已安装
uv。可以通过以下命令安装:pip install uv -
系统环境:默认情况下,
uv要求使用虚拟环境。如果需要在系统 Python 环境中安装包,需添加--system标志,但需谨慎使用。
示例工作流程
假设你有一个项目目录 my_project:
cd my_project
uv venv # 创建 .venv 虚拟环境
source .venv/bin/activate # 激活虚拟环境
uv pip install numpy pandas # 安装依赖
完成后,项目将在隔离的虚拟环境中运行,避免与系统或其他项目的依赖冲突。