在 Windows 上安装 uv

在 Windows 上，推荐使用 PowerShell 通过官方安装脚本安装。

1. 以管理员身份打开 PowerShell ：在任务栏搜索框输入 PowerShell，右键点击并选择"以管理员身份运行"。

2. 执行安装命令：复制并粘贴以下命令到 PowerShell 中，按回车运行：

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

3. 验证安装 ：安装完成后，关闭当前 PowerShell 窗口，重新打开一个，然后输入以下命令验证是否成功：

   uv --version

   如果看到类似 uv 0.x.x 的版本号，就说明安装成功了。

2. 使用 uv 管理 Python 版本

uv 管理 Python 版本的命令风格和 NVM 很像，很容易上手。

• 查看可用的 Python 版本：

  uv python list

  这会列出所有可供 uv 安装和已安装的 Python 版本。

• 安装特定版本的 Python：例如，安装 Python 3.12：

  uv python install 3.12

  你还可以同时安装多个版本：

  uv python install 3.11 3.12

  uv 默认安装的 Python 可能不会将 python 命令添加到系统的全局 PATH 中，但 uv 自己可以自动检测并使用它，不影响在项目中的使用。

• 为项目固定 Python 版本 ：在你的项目目录下，使用以下命令可以创建一个 .python-version 文件，锁定当前项目使用的 Python 版本：

  uv python pin 3.12

3. 创建并管理项目（推荐工作流）

uv 提倡"项目即环境"的理念，它会自动为每个项目创建和管理独立的虚拟环境，非常方便。

1. 初始化一个新项目 ：在项目文件夹中，运行以下命令，它会生成 pyproject.toml（项目配置和依赖清单）和 .python-version 等文件。

   uv init

2. 添加依赖 ：使用 uv add 命令安装包，它会自动将依赖添加到 pyproject.toml 并锁定版本。

   uv add requests

3. 同步环境 ：当你的依赖清单（pyproject.toml）发生变化时，使用此命令确保虚拟环境与清单完全一致。

   uv sync

4. 运行脚本 ：无需手动激活虚拟环境，uv run 会自动在项目的隔离环境中执行命令。

   uv run python my_script.py

5. 获取 Python 的完整路径：uv python find。

   uv python find

总结

通过 uv，你可以告别手动下载 Python 安装包、管理 PATH 环境变量以及处理 pip 和 venv 的繁琐步骤。它用一个统一的、快速的命令行工具接管了整个 Python 开发工作流。