跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

Windows 系统下 Python 新一代包管理工具 uv 及 VSCode 配置

综述由AI生成Python 新一代包管理工具 uv 在 Windows 下的安装、配置及使用。内容包括通过 pip 或 PowerShell 安装 uv,配置阿里云镜像源加速下载,创建集中式或项目级虚拟环境。此外,详细说明了如何在 VSCode 中配置解释器路径以识别 uv 环境,并演示了 uv init、uv add、uv sync 等核心命令实现高效的依赖管理与项目初始化。

极客工坊发布于 2026/3/30更新于 2026/5/2328 浏览
Windows 系统下 Python 新一代包管理工具 uv 及 VSCode 配置

Python 新一代包管理工具 uv

uv 是什么?

uv 是用 Rust 语言编写的 Python 包和项目管理工具,详见官网。

文章配图

uv 的安装

官网上提供了两种安装方式。第一种需要在 PowerShell 终端里运行以下命令:

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

另一种方式是如果已经安装过 Python,可以直接使用 pip 安装:

pip install uv

设置镜像源

虽然 uv 速度很快,但有时感觉较慢,通常是因为镜像源问题。建议配置国内镜像源。

手动在文件路径栏输入 %APPDATA%,在该目录下创建 uv 文件夹并进入。然后在 uv 文件夹里创建 uv.toml 文件并打开,内容为:

[[index]] url = "http://mirrors.aliyun.com/pypi/simple/" default = true 

注:url 为 Python pip 的镜像源地址,阿里云镜像源仅为示例,其他可用镜像源亦可。

创建虚拟环境

uv 创建虚拟环境有两种方式:统一创建管理或跟随项目创建。这里介绍统一创建方式。

首先创建一个 uvenv 文件夹用于集中放置虚拟环境,例如 C:\uvenv。

打开 cmd 进入该路径,使用如下命令创建虚拟环境,其中 env_name 为虚拟环境命名,--python 指定 Python 版本:

uv venv env_name --python 3.xx

此时虚拟环境已创建,运行以下命令激活:

env_name\Scripts\activate

注意:如果遇到报错,可尝试以管理员身份运行 PowerShell,执行 set-executionpolicy remotesigned 解除限制。

接下来即可在该虚拟环境下安装 Python 三方库,安装命令直接在 pip install 前加入 uv 即可:

uv pip install xxx

删除某个库与 pip 类似,运行 uv pip uninstall 即可。

配置 VSCode

由于 uv 是新出的工具,VSCode 可能无法自动索引创建的虚拟环境,需进行配置。

依次打开 VSCode、设置、转换为 JSON,并在最后添加以下内容(注意替换为你的实际路径):

{
    "python.venvPath": "C:\\uvenv",
    "python.venvFolders": ["C:\\uvenv"]
}

文章配图

文章配图

至此 VSCode 就能检测到 uv 所创建的虚拟环境了。可以运行命令面板,输入 Python: Select Interpreter 进行验证。

文章配图

使用 uv 进行项目管理

首先用 VSCode 打开一个空项目(空文件夹),在终端里运行 uv init,即可对项目进行初始化,会自动创建 Git 管理、Python 环境依赖和项目信息。

在该项目下,可以在终端输入 uv venv --python 3.xxx,即可以创建适合该项目的 Python 版本。

然后再次运行 uv venv 即可以创建适合该项目的虚拟环境。

文章配图

使用 uv add xxx 即可给该项目环境安装具体的三方库,且项目环境文档会自动更新!

文章配图

另外,拿到别人的项目的话可以使用 uv sync 对他人项目环境进行复制。

文章配图

uv 项目管理常用命令小结

  • uv init: 初始化项目
  • uv venv: 创建虚拟环境
  • uv add: 添加依赖
  • uv sync: 同步依赖

目录

  1. Python 新一代包管理工具 uv
  2. uv 是什么?
  3. uv 的安装
  4. 设置镜像源
  5. 创建虚拟环境
  6. 配置 VSCode
  7. 使用 uv 进行项目管理
  8. uv 项目管理常用命令小结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • FPGA 设计调试:Vivado ILA 高级触发模式配置
  • llama.cpp 本地部署常见问题与解决方案
  • RabbitMQ 常见工作模式及发布确认实现
  • Windows 本地大模型工具链安装:Ollama + llama.cpp + LLaMA Factory
  • 低代码 AI 平台:Coze 与 Dify 深度对比
  • C++ 类和对象:拷贝构造函数与运算符重载详解
  • JavaScript 同步与异步机制详解
  • Java在AI时代的崛起:从传统机器学习到AIGC的全栈解决方案
  • OpenClaw + 飞书 Agent 构建 AI 自主模拟炒股系统实战
  • AI 辅助快速生成 Mermaid 图表实战指南
  • 基于 Llama-Factory 微调 Qwen3.5-4B 模型指南
  • 2026 主流 AI 大模型全方位横评与选型指南
  • 2025 技术成长复盘:从 Java 基础到 AI 智能体开发实践
  • 英伟达开源 DreamDojo:4.4 万小时数据破解机器人训练难题
  • Python 修改 pip 默认安装路径的几种方法
  • 大模型微调实战指南:使用 LLaMA Factory
  • 小狼毫输入法配置指南:拼音、五笔、注音方案设置
  • AI 代码助手深度对比:CodeGeex、RooCode 与 GitHub Copilot
  • LLM 应用为何需要文本加载器及 LangChain 使用方法
  • 机器人编程基础:工业与家用机器人的核心差异

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online