Windows 下使用 uv 从零配置 Python 及 OpenCV 环境

Windows 下使用 uv 从零配置 Python (OpenCV) 环境指南

本文档适用于在一台全新的 Windows 电脑上，使用 uv 快速配置 VS Code + Python 3.10 开发环境，并安装 OpenCV 库。同时包含关于 uv 的进阶说明。

---

🟢 第一步：安装 uv 包管理器

既然电脑上什么都没有，我们需要先安装这个核心工具。

1. 按下 Win + R 键，输入 powershell，按回车打开终端。
2. 复制并粘贴以下命令，按回车运行（三选一）：
   • 方式一：下载解压后，将包含 uv.exe 的文件夹路径添加到系统环境变量的 Path 中。
   • 方式二：若已安装 pip，可通过镜像站下载：

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

   • 方式三：使用官方 PowerShell 脚本：

     irm https://astral.sh/uv/install.ps1 | iex
     

3. 安装完成后，关闭并重新打开 PowerShell 窗口。

配置国内镜像源

由于官方源服务器在国外，为了解决下载速度慢、连接超时的问题，建议配置 uv 使用国内镜像源（清华源）。请直接复制下方所有代码，在 PowerShell 终端中一次性粘贴并回车运行：

# 1. 创建配置目录（如果不存在）
New-Item -Path "$env:APPDATA\uv" -ItemType Directory -Force

# 2. 写入配置内容到 uv.toml (使用清华源)
$content = @"
[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true
"@
Set-Content -Path "$env:APPDATA\uv\uv.toml" -Value $content

运行完成后，您的 uv 全局下载配置即已更新为清华源。

验证安装：

uv --version

(如果看到版本号，说明安装成功)

---

🟡 第二步：创建项目并初始化

我们不使用全局环境，而是为每个项目创建一个独立环境（这是最佳实践）。

1. 在电脑上新建一个文件夹（例如 my-opencv-project）。
2. 打开 VS Code。
3. 点击菜单栏 File (文件) -> Open Folder (打开文件夹)，选择刚才新建的文件夹。
4. 使用快捷键 Ctrl + ~ (Esc 下面那个波浪号键) 打开 VS Code 内置终端。
5. 在终端依次输入以下命令：

指定 Python 版本为 3.10：

uv python pin 3.10

(uv 会自动为你下载并管理 Python 3.10，无需你去官网下载)

修改 .toml 文件：

[project]
name = "vision-winer-camp"
version = 
 = 
 = 
 = [
    ,
]