`uv` 命令是一个用于创建和管理虚拟环境

使用 uv 命令创建 Python 虚拟环境非常简单。以下是具体步骤和常用命令:

基本命令

  1. 创建虚拟环境

    uv venv
    

    这会在当前目录下创建一个名为 .venv 的虚拟环境。如果想自定义虚拟环境目录名,可以指定:

    uv venv my_env
    

    其中 my_env 是自定义的虚拟环境目录名。

  2. 指定 Python 版本: 如果需要使用特定的 Python 版本,可以通过 --python 参数指定:

    uv venv --python 3.12
    

    例如,上述命令会使用 Python 3.12 创建虚拟环境。如果系统中没有指定版本,uv 会尝试下载对应的 Python 版本。

  3. 激活虚拟环境

    • 在 Linux/macOS 上:
      source .venv/bin/activate
      
    • 在 Windows 上:
      .venv\Scripts\activate
      

    激活后,终端会切换到虚拟环境,提示符通常会显示虚拟环境的名称。

  4. 验证虚拟环境: 激活虚拟环境后,可以检查 Python 解释器路径以确认:

    which python
    

    如果路径指向 .venv/bin/python(Linux/macOS)或 .venv\Scripts\python(Windows),则说明虚拟环境已正确激活。

高级用法

  • 自动创建虚拟环境: 如果你在项目中运行 uv adduv run 等命令,uv 会在项目根目录自动创建 .venv 虚拟环境(如果不存在)。

  • 跨平台虚拟环境管理: 如果在 Windows 和 Linux 之间共享项目(如通过 WSL),可以为不同平台设置不同的虚拟环境目录。例如,使用环境变量 UV_PROJECT_ENVIRONMENT 指定虚拟环境路径:

    export UV_PROJECT_ENVIRONMENT=.venv_linux
    

    或者通过配置文件(如 .uv_linux)指定。

  • 删除虚拟环境: 要删除虚拟环境,只需删除虚拟环境目录:

    rm -rf .venv
    

    然后可以重新创建。

注意事项

  • 安装 uv:确保已安装 uv。可以通过以下命令安装:

    pip install uv
    

    或者使用官方提供的安装脚本。

  • 默认行为uv 创建的虚拟环境不默认安装 pipsetuptools,需使用 uv pip 管理包。

  • 系统环境:默认情况下,uv 要求使用虚拟环境。如果需要在系统 Python 环境中安装包,需添加 --system 标志,但需谨慎使用。

示例工作流程

假设你有一个项目目录 my_project

cd my_project
uv venv  # 创建 .venv 虚拟环境
source .venv/bin/activate  # 激活虚拟环境
uv pip install numpy pandas  # 安装依赖

完成后,项目将在隔离的虚拟环境中运行,避免与系统或其他项目的依赖冲突。

如需更多详细信息,可参考官方文档:https://docs.astral.sh/uv/

使用 Hugo 构建
主题 StackJimmy 设计