skip to content
rainbow ゆめこ

uv虚拟环境

/ 3 min read

升级到 Python 3.13 后,可能会遇到兼容性问题,因为应用程序或其插件/依赖需要时间来适配新的 Python 版本。

如果您已将 Python 3.13 加入 PATH,使其成为全局默认的 python 命令,您仍然可以使用 uv 工具来创建基于特定旧版本(如 3.11.9)的虚拟环境。通过在创建时明确指定解释器路径或版本,可以确保虚拟环境不受全局 PATH 的影响。

如何确保 uv 命令可用(Windows)

如果您将 uv 安装在全局 Python 环境下(例如 Python 3.13),您需要将该 Python 安装的 Scripts 目录添加到系统的 PATH 环境变量中,以便在任何地方运行 uv 命令。

  1. 复制该路径(假设 uv 安装在 Python 3.13 环境中):

    %USERPROFILE%\AppData\Roaming\Python\Python313\Scripts
  2. 打开“系统属性” → “环境变量”。

  3. 在“用户变量”或“系统变量”里找到 Path 变量,点击“编辑”。

  4. 新增一行,将复制的路径粘贴进去,确定保存。

  5. 重新打开命令行窗口,使新的 PATH 生效。


使用 uv 创建特定版本虚拟环境的操作流程总结

这里总结了使用 uv 创建一个基于 Python 3.11.9 虚拟环境的步骤,即使你的全局 python 命令指向 3.13。

  1. 确保全局 PATH 中包含 Python 3.13 的 Scripts 目录 (包含 uv) 这样你可以在任何地方直接使用 uv 命令。全局的 python 命令将默认启动 3.13。

  2. 使用 uv 指定 Python 3.11.9 创建虚拟环境 只需在命令行运行:

    Terminal window
    uv venv zzz_env --python=3.11.9

    这会在当前目录下创建一个名为 zzz_env 的虚拟环境,它将使用 Python 3.11.9 作为解释器。

  3. 激活虚拟环境并安装依赖 首先激活虚拟环境:

    Terminal window
    zzz_env\Scripts\activate

    激活后,命令行提示符通常会显示虚拟环境的名称。然后安装依赖:

    Terminal window
    pip install -r requirements-prod.txt

    (注意:上述两个命令通常分两步执行)

  4. 检查虚拟环境的 Python 版本已激活的虚拟环境中,运行:

    Terminal window
    python --version

    应输出 Python 3.11.9。这确认虚拟环境正在使用指定的版本。