uv 是一个 Python 虚拟环境管理工具比 Anaconda 更轻量且效率高适合简单 Python 脚本以及 Agent 开发使用本文将介绍 uv 下载、配置、使用以及结合 PyCharm 的工作流uv 官网https://docs.astral.sh/uv/一、下载与配置很多同学安装 uv 后发现它还是往 C 盘塞东西。通过以下方法可以将 uv 的主程序、Python 解释器库、缓存以及镜像源全部定向到 D 盘(一) 目录结构规划首先手动创建一个核心根目录我们以 D:\Code\Python\UV 为例作者是这样分区的之后也以此为例可自行更换 UV 文件夹前的目录结构并在其下建立三个核心子文件夹bin存放 uv 可执行程序cache存放所有包的缓存这是占用空间最大的地方python存放 uv 下载的各版本 Python 解释器效果如下(二) 环境变量核心配置这是最关键的一步通过 Windows用户环境变量进行重定向变量名变量值 (示例)作用UV_PYTHON_INSTALL_DIRD:\Code\Python\UV\python强制 uv 将下载的 Python 解释器装到 D 盘UV_CACHE_DIRD:\Code\Python\UV\cache强制将包缓存存入 D 盘UV_DEFAULT_INDEXhttps://pypi.tuna.tsinghua.edu.cn/simple设置清华镜像源加速下载Path添加项D:\Code\Python\UV\bin确保在任何目录下都能直接运行 uv 命令效果如下注意Path 中的添加项即 D:\Code\Python\bin最好放在第一个从而避免与其他 Python 冲突如 Anaconda 中的 Python 环境因为我们需要优先使用的是 uv如果 Anaconda 还需要使用可以单独在 Anaconda Prompt 中使用 Conda 语句如下(三) 下载以管理员身份运行 PowerShell输入以下命令自行替换 D:\Code\Python\UV\bin# 1. 在当前会话中明确指定安装目录确保脚本知道去哪 $env:UV_INSTALL_DIR D:\Code\Python\UV\bin # 2. 执行官方下载并安装脚本 powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex$env:UV_INSTALL_DIR说明: 官方安装脚本会检查这个变量。如果你不设置它默认会去 C:\Users\用户名\.cargo\bin。设置后它会直接把 uv.exe 和 uvx.exe 下载到你指定的 D:\Code\Python\UV\bin可使用以下命令检查# 1. 检查 uv where.exe uv # 2. 检查 cache uv cache dir效果应如下现在我们就完成 uv 下载和配置了二、基本使用1. 环境管理uv 以“项目”为单位管理环境他会为每个项目创建独立的 .venv 文件创建新项目自动初始化环境uv init my_project # 这会创建一个文件夹里面包含 Python 配置文件 uv init # 这会在当前文件夹创建项目创建虚拟环境uv venv # 默认创建在当前目录的 .venv 文件夹 uv venv --python 3.9 # 指定 Python 版本激活环境使用 uv run 命令时无需手动激活查看依赖树清晰展示包的层级关系uv tree删除环境直接删除项目下的 .venv 文件夹即可彻底清理2. 包管理安装与记录依赖自动安装并记录到项目配置中uv add openai # 安装最新版 uv add openai1.10.0 # 指定版本 uv add --dev pytest # 标记为开发依赖卸载包uv remove openai同步环境根据配置文件一键恢复环境状态uv sync # 根据配置文件一键把环境恢复成规定状态查询包信息uv pip list # 列出已安装包 uv pip show package_name # 查看包详情3. Python 版本管理这是 uv 杀手级的功能它能直接管理电脑上的 Python 本身列出电脑上及官方库里所有的 Python 版本uv python list安装指定版本它会乖乖装进你指定的 D:\Code\Python\UV\python 目录uv python install 3.12在当前目录临时切换 Python 版本uv venv --python 3.104. 运行与执行直接运行脚本uv 会自动检查依赖是否装好自动在环境里运行你连 activate 都不用输入uv run main.py临时运行工具uvx 会下载、运行、然后清理不占地方uvx textual-paint5. 配置与维护查看缓存路径uv cache dir清理缓存uv cache clean更新工具自身uv self update6. uv 工作流串联前文的 uv 命令我们将 uv 的工作流总结为“初始化 - 开发 - 运行 - 维护”四个核心阶段6.1. 项目启动初始化每当你有一个新点子比如想写个新 Agent 时1. 初始化项目uv init my_project (这会创建一个文件夹里面包含 Python 配置文件) uv init (这会在当前文件夹创建项目)结果它会生成pyproject.toml项目清单和hello.py注意此时还没创建虚拟环境不用急2. 创建虚拟环境uv venv (默认创建在当前目录的 .venv 文件夹) uv venv --python 3.9 (指定 Python 版本)6.2. 依赖管理装包你想用什么功能就“加”什么包1. 添加普通依赖如 OpenAI SDKuv add openai python-dotenv langchain2. 添加开发依赖如代码格式化工具项目运行不需要但写代码需要uv add --dev ruff pytest3. 移除包可选uv remove langchain6.3. 代码运行无需激活这是 uv 最爽的地方你永远不需要手动执行 activate 命令1. 直接运行脚本uv run hello.py原理uv run 会自动识别当前目录下的 .venv进去跑完代码然后出来2. 运行特定的 Python 命令uv run python -m some_module6.4. 环境同步与协作克隆别人的项目如果你从 GitHub 下载了一个别人的 Agent 项目或者在另一台电脑上继续开发1. 一键还原环境uv sync结果uv 会读取 pyproject.toml自动把 Python 版本和所有包安装得一模一样6.5. Python 版本控制按需切换如果你的 Agent 需要在特定版本下运行下载指定版本uv python install 3.12强制当前项目使用特定版本uv venv --python 3.126.6. 临时工具调用uvx 魔法如果你只想临时用一个 Python 工具比如想看一眼某个 JSON 文件或者用某个爬虫工具但不想把它装进你的项目里uvx some-tool-name结果uv 会创建一个临时环境运行它运行完自动销毁不占空间不污染你的项目以上就是 uv 的简单使用三、uv PyCharm 联合使用PyCharm 在 Python 编程方面运用十分广泛在这部分会介绍 uv 结合 PyCharm 的工作流作者本人总结可能有不足(一) 首先先介绍一下 Pycharm 中环境的选择利用 PyCharm 新建项目时有三种解释器选择以下是说明1. 项目 venv ——最常用含义这是 Python 官方的标准虚拟环境。它是在你的项目文件夹里创建的一个独立的 .venv 文件夹特点独立性环境跟着项目走。删掉项目文件夹环境也就没了轻量只包含运行该项目必需的包与 uv的关系uv也是为当前项目创建 .venv但在使用上可跳过创建项目以及选择解释器步骤具体见后文“uv PyCharm 终极工作流CLI 优先”2. 基础 conda ——Anaconda 的“新开户”含义这是让 PyCharm 调用 conda.exe 去创建一个全新的Conda 虚拟环境特点环境通常存储在你指定的 envs_dirs 目录下而不是在项目文件夹里你可以利用 Conda 强大的科学计算包管理能力使用场景你想为这个新项目创建一个全新的 Conda 环境时选它3. 自定义环境 ——“老兵报道”含义这是指使用电脑上已经存在的 Python 解释器特点复用性如果已有配置好的虚拟环境如 Conda 虚拟环境而你现在的项目也想用这个直接选它就行使用场景你想让新项目直接“套用”以前建好的 Conda 虚拟环境或全局 Python(二) uv PyCharm 终极工作流CLI 优先这套流程的核心是把环境管理的权力完全交给 uvPyCharm 只需要闭着眼睛用1. 第一步在终端CLI一气呵成不要在 PyCharm 的“新建项目”界面纠结直接在 PowerShell 里操作uv init my_agent_project # 1. 创建项目结构 cd my_agent_project # 2. 进入目录 uv venv --python 3.13 # 3. 可省略 uv add openai langchain # 4. 核心这一步会自动创建 .venv 并安装包2. 第二步PyCharm 直接“拎包入住”2.1 打开 PyCharm点击Open不要点 New Project2.2 选中刚才的 my_agent_project 文件夹2.3 PyCharm 的自动感应现在的 PyCharm 非常聪明。它看到目录下有 .venv 文件夹通常会直接弹窗问你Python virtual environment found. Do you want to use it?直接点OK如果它没弹窗你只需要在右下角点击 Python 解释器手动指向一次项目里的 .venv/Scripts/python.exe。全过程只需这一回如下图一般会自动识别到