Windows 下使用 uv 从零配置 Python (OpenCV) 环境指南
本文档适用于在一台全新的 Windows 电脑上，使用
uv快速配置 VS Code + Python 3.10 开发环境，并安装 OpenCV 库。同时包含关于uv的进阶说明。
🟢 第一步：安装 uv 包管理器
既然电脑上什么都没有，我们需要先安装这个核心工具。
- 按下
Win + R键，输入powershell，按回车打开终端。 - 复制并粘贴以下命令，按回车运行（三选一）：
- 或者进入 uv 下载链接 找到
uv-x86_64-pc-windows-msvc.zip下载解压后，将包含uv.exe的文件夹路径（例如 D:\tools\uv）添加到系统环境变量的 Path 中。
- 或者进入 uv 下载链接 找到
- 安装完成后，关闭并重新打开 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
(如果看到版本号，说明安装成功)
如果你电脑上已经安装了 Python，也可以直接通过镜像站下载：
pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple
或者使用官方脚本：
irm https://astral.sh/uv/install.ps1 | iex
🟡 第二步：创建项目并初始化
我们不使用全局环境，而是为每个项目创建一个独立环境（这是最佳实践）。
- 在电脑上新建一个文件夹（例如
my-opencv-project）。 - 打开 VS Code。
- 点击菜单栏 File (文件) -> Open Folder (打开文件夹)，选择刚才新建的文件夹。
- 使用快捷键
Ctrl + ~(Esc 下面那个波浪号键) 打开 VS Code 内置终端。 - 在终端依次输入以下命令：
指定 Python 版本为 3.10：
uv python pin 3.10
(uv 会自动为你下载并管理 Python 3.10，无需你去官网下载)
初始化项目：
uv init
