1. 可以直接在 cmd 中用 pip install uv 下载吗?

可以,但这不是官方最推荐的方式。 如果你直接在 cmd 中运行 pip install uv,它会把 uv 安装到你系统的全局 Python 环境中。

  • 缺点: 如果用 pip 安装,将无法使用 uv 内置的极速自更新命令(uv self update),未来你每次更新都必须手动运行 pip install --upgrade uv。官方建议,如果一定要走 PyPI,最好使用 pipx install uv 将其隔离。

2. 为什么不需要创建虚拟环境?

uv 作为一个极速的 Python 包和项目管理工具(用 Rust 编写),它的核心工作之一就是帮你创建和管理虚拟环境。

你可以把它理解为系统的全局基础工具,它本身甚至不需要依赖 Python 就能运行。你应该在“全局”安装它,然后用它去为你未来的项目创建虚拟环境(例如使用 uv venv 或 uv init)。

3. 官方最推荐的安装方式(独立安装脚本)

为了保持系统的纯净并且支持内置自更新,官方最推荐使用他们提供的独立安装脚本。你可以在任意目录下打开命令行执行以下命令:

  • 如果你使用的是 Windows:

    请打开 PowerShell(而不是 cmd),直接粘贴并回车运行:

    PowerShell

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    
  • 如果你使用的是 macOS 或 Linux:

    请打开 终端 (Terminal),运行:

    Bash

    curl -LsSf https://astral.sh/uv/install.sh | sh
    

如果:遇到了网络的问题,报错如图:

你遇到的情况是这样的:

  1. 第一次: 直接请求 astral.sh,无DL所以“无法连接到远程服务器”。

  2. 第二次):  PowerShell 的命令行环境默认是不会自动走系统DL的。所以 irm(Invoke-RestMethod)命令依然在尝试直连,最终导致连接被关闭或 TLS 握手失败。

如果已经安装了 Anaconda 或 Miniconda,且环境里有 pip。

方法一:直接用 pip 加上国内镜像源安装(最推荐,最快)

直接在当前的终端里运行:

PowerShell

pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple

方法二:

  1. 打开DL,查看它的本地 HTTP 代理端口(查看自己的端口是哪个)

  2. 在 PowerShell 中依次运行以下命令(假设你的端口是 7890,如果不是请替换):

    PowerShell

    $env:HTTP_PROXY="http://127.0.0.1:7890"
    $env:HTTPS_PROXY="http://127.0.0.1:7890"
    
  3. 设置好后,在同一个窗口中再次运行官方脚本:

    PowerShell

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    

方法三:去 GitHub 手动下载(纯图形界面操作)

  1. 打开浏览器访问:uv GitHub Releases 页面

  2. 找到最新的版本(比如 v0.x.x),在底部的 Assets 里找到 uv-x86_64-pc-windows-msvc.zip 并下载。

  3. 解压后,里面就只有一个 uv.exe 文件。

  4. 把这个文件放到你平常喜欢放软件的目录,然后把这个目录添加到系统的环境变量 (Path) 里就可以了。

更多推荐