uv 无内置命令删除虚拟环境,需手动确认路径后用 rm/rmdir 或 python 脚本删除目录,可选清理 cache/environments 下对应 json 元数据。

使用 uv 删除 Python 虚拟环境需要明确指定环境路径,uv 本身不维护全局环境注册表,也不会自动识别或清理未被记录的目录;直接删除文件夹虽可行,但可能残留依赖缓存或导致后续命令行为异常。
确认虚拟环境路径
uv 不保存环境位置记录,必须手动确认路径。若通过 uv venv /path/to/venv 创建,则路径就是 /path/to/venv;若记不清,可检查终端当前命令中显式写出的路径,或用 which python(Linux/macOS)或 where python(Windows)定位可执行文件,再向上追溯至父目录。
这一步跳过会导致删错目录——【删错路径不可恢复】。
用 uv 自带命令删除(推荐)
uv 从 0.2.0 版本起提供 uv python remove 子命令,但它只管理 Python 解释器安装,不处理虚拟环境。因此 uv 当前没有内置命令专门用于删除虚拟环境。
所谓“用 uv 删除”,实际是配合 shell 命令完成清理。
安全删除虚拟环境目录
方法一:命令行直接移除
Linux/macOS 执行:rm -rf /path/to/venv;Windows 执行:rmdir /s /q C:\path\to\venv。
方法二:用 Python 脚本跨平台删除(避免手误)
新建临时脚本 del_venv.py,内容为:
import shutil, sysshutil.rmtree(sys.argv[1])
然后运行:python del_venv.py /path/to/venv。
方法三:IDE 或文件管理器手动删除
在 VS Code、PyCharm 等工具中关闭对应解释器关联后,直接在资源管理器中选中文件夹 → 删除。注意先退出所有引用该环境的终端和编辑器进程,否则 Windows 可能提示“正在使用中”。
清理 uv 缓存中的相关痕迹(可选)
第一步:查看 uv 缓存位置
运行 uv cache info,关注 Cache directory 行输出的路径。
第二步:进入该缓存目录 → 打开 environments 子目录
该目录下存放的是 uv 创建虚拟环境时生成的元数据快照(JSON 文件),不是环境本身。若你用 uv 创建过环境,此处会有对应哈希命名的文件。
第三步:删除与目标环境路径匹配的 JSON 文件
打开每个 JSON 文件,查找 "root" 字段值是否等于你刚删掉的虚拟环境路径。匹配则删除该 JSON;不匹配请跳过——【误删其他 JSON 可能影响 uv future venv 创建速度】。
第四步:保留 archives 和 wheels 目录不动
它们存储下载的 Python 解释器和 wheel 包,与虚拟环境生命周期无关,无需清理。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











