uv创建的虚拟环境默认在当前目录下生成.venv文件夹,但可通过UV_PROJECT_ENVIRONMENT指定父目录或直接用uv venv D:\path显式指定路径,避免误落C盘。

uv 创建的虚拟环境默认存放在当前项目目录下的 .venv 文件夹里,和 venv 或 virtualenv 一致。但这个位置**不是固定的**,它受多个环境变量和命令参数控制,稍不注意就会误落到 C 盘。
默认行为:为什么你的 .venv 还在 C 盘?
即使你把 UV_PYTHON_INSTALL_DIR 和 UV_CACHE_DIR 指向了 D 盘,uv venv 仍会默认在当前目录(比如 C:\projects\myapp)下建 .venv。如果你项目本身就在 C 盘,那虚拟环境自然也在 C 盘——这和 uv 的缓存、解释器路径完全无关。
UV_PROJECT_ENVIRONMENT 控制全局项目级虚拟环境根目录
这个变量指定的是“所有项目默认虚拟环境的父目录”,不是单个 .venv 的绝对路径。它只在你**不显式指定 --python 或 --system-site-packages 等参数时**才生效。
- Windows:设置
UV_PROJECT_ENVIRONMENT="D:\Python\uv\envs" - Linux/macOS:在
.bashrc中加export UV_PROJECT_ENVIRONMENT="$HOME/developer/uv/envs" - 效果:执行
uv venv时,会在该目录下按项目名自动创建子文件夹,如D:\Python\uv\envs\myapp
uv venv --python 后面的路径决定实际存放位置
最直接、最可靠的方式是**显式指定路径**,完全绕过任何环境变量逻辑:
-
uv venv D:\Python\envs\myproject→ 虚拟环境直接建在 D 盘指定路径 -
uv venv --python 3.12 D:\Python\envs\fastapi-api→ 指定 Python 版本 + 显式路径 - 注意:
--python参数值可以是版本号(触发自动下载)、系统路径(如C:\Python312\python.exe),或已安装的 uv 解释器 ID(如cpython-3.12.7-windows-x86_64-none)
PyCharm 中怎么确保用上 D 盘的虚拟环境?
PyCharm 不读取 UV_PROJECT_ENVIRONMENT,它只认你手动选的解释器路径。所以:
立即学习“Python免费学习笔记(深入)”;
- 先用命令行在 D 盘创建好环境:例如
uv venv D:\Python\envs\pycharm-proj - 打开 PyCharm → File → Settings → Project → Python Interpreter → Add Interpreter → System Interpreter → 浏览到
D:\Python\envs\pycharm-proj\Scripts\python.exe(Windows)或D:/Python/envs/pycharm-proj/bin/python(macOS/Linux) - 别选 “Existing environment” 里的自动扫描结果——它常会扫出 C 盘残留的老环境
uv venv 命令本身没有任何强制落盘策略。想稳稳落在 D 盘,就老老实实写全路径。


















