使用 uv 在 Windows 上快速搭建 Python 开发环境

本教程将指导你如何在 Windows 系统上,使用 uv(一个由 Ruff 的作者开发的极速 Python 打包和项目管理工具)来快速创建虚拟环境并安装项目依赖。uv 可以看作是 venvpip 的一个更快、更现代的替代品。

环境要求

  • Windows 操作系统

  • 已安装 Python (本教程以 Python 3.12 为例)

  • Windows PowerShell


步骤 1: 安装 uv

首先,我们需要安装 uv。这里提供两种方法。

方法一:官方推荐脚本 (推荐)

  1. 从开始菜单搜索 PowerShell,然后选择 "以管理员身份运行"
  1. 在弹出的管理员 PowerShell 窗口中,执行以下命令,它会自动下载并安装 uv
powershell 复制代码
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

方法二:使用 pip 安装

如果你已经有一个可用的 Python 环境,也可以通过 pip 来安装 uv

powershell 复制代码
pip install uv

验证安装

安装完成后,可以运行以下命令检查 uv 版本,以确认安装成功。

powershell 复制代码
uv --version

如果成功,你会看到类似下图的版本号输出:

步骤 2: 创建并激活虚拟环境

项目开发的第一步是创建一个隔离的虚拟环境,以避免包版本冲突。

  1. 在你希望创建项目的文件夹中(例如 D:\uv-test),打开 PowerShell。

  2. 使用以下命令创建一个名为 .venv 的虚拟环境,并指定使用 Python 3.12:

powershell 复制代码
uv venv --python 3.12
  1. 激活虚拟环境

为了能在当前终端会话中使用这个新环境,你需要激活它。

注意:首次在 PowerShell 中运行脚本时,可能会因为安全策略而被阻止。你需要先执行以下命令来允许当前会话运行脚本。

powershell 复制代码
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

当系统提示时,输入 Y 并按回车。

现在,执行激活命令:

powershell 复制代码
.venv\Scripts\activate

成功激活后,你的命令行提示符前面会出现 (.venv) 的字样,如下图所示,表示你已进入虚拟环境。

步骤 3: 初始化项目并安装依赖

激活环境后,我们就可以开始管理项目依赖了。

  1. 初始化项目

运行 uv init 会在当前目录下创建一个 pyproject.toml 文件。这个文件用于记录你的项目信息和依赖项,类似于 requirements.txt 但功能更强大。

powershell 复制代码
uv init
  1. 添加项目依赖

现在,让我们安装一些常用的数据科学库。使用 uv add 命令可以同时完成安装和将依赖项写入 pyproject.toml 文件。为了加快下载速度,我们使用 -i 参数指定了清华大学的 PyPI 镜像源。

powershell 复制代码
uv add numpy pandas matplotlib scikit-learn seaborn -i https://pypi.tuna.tsinghua.edu.cn/simple

uv 会以极快的速度解析并安装这些包。


恭喜!

你已经成功地使用 uv 创建了一个干净、隔离的 Python 开发环境,并安装了所需的库。

后续常用操作:

  • 查看已安装的包uv pip list

  • 退出虚拟环境deactivate

如果你觉得这篇教程对你有帮助,欢迎访问我的博客 blog.mashijian.com 获取更多关于AI、大模型和深度学习的实战教程与技术分享!

相关推荐
ZHOU_WUYI4 小时前
构建实时网络速度监控面板:Python Flask + SSE 技术详解
网络·python·flask
chinesegf4 小时前
conda虚拟环境直接复制依赖包可能会报错
python·conda
开心-开心急了4 小时前
PySide6 打印(QPrinter)文本编辑器(QPlaintextEdit)内容
python·ui·pyqt
坐吃山猪5 小时前
Python-UV多环境管理
人工智能·python·uv
带娃的IT创业者5 小时前
从零开始掌握 uv:新一代超快 Python 项目与包管理器(含 Windows 支持)
windows·python·uv
浔川python社5 小时前
浔川 AI 翻译 v7.0正式上线公告
python
Wiktok5 小时前
【WIT】ttkbootstrap全组件中文本地化解决方案
python·ttkbootstrap
熊猫钓鱼>_>5 小时前
PySpark全面解析:大数据处理的Python利器
开发语言·python
王嘉俊9255 小时前
Django 入门:快速构建 Python Web 应用的强大框架
前端·后端·python·django·web·开发·入门