uv 包管理详解

所有下载/缓存

都在 uv cache 里

Windows 默认:

%LOCALAPPDATA%\uv\cache
# 一般对应:
# C:\Users\你的用户名\AppData\Local\uv\cache

查看路径命令:

uv cache dir

cache 里的目录分工

  • archive‑v0/:
    放解压后的包文件(.whl 解包出来的那一堆),你的 funasr、onnxruntime、numpy 解压后都在这里,然后硬链接到项目的 .venv/Lib/site-packages。
  • wheels‑v1/:
    放原始 .whl 压缩包(没解压的)。
  • sources‑v3/:
    放源码包(.tar.gz)。
  • metadata‑v13/:
    放包的元数据(版本、依赖等)。

简单记:

  • wheels‑v1 = 压缩包(原始)
  • archive‑v0 = 解压后的文件(实际被链接到虚拟环境)

虚拟环境里的包

不是复制,是“硬链接”

你项目里:

D:\xxx\.venv\Lib\site-packages\funasr

其实是指向:

C:\Users\你\AppData\Local\uv\cache\archive‑v0\...

的硬链接,所以:

  • 多个项目用同一个包,磁盘只存一份(省空间)。
  • 删项目 .venv,不会删 cache 里的包,下次装还能复用。

结论

  • ✅ 你安装的所有库,解压后都在 archive‑v0。
  • ✅ 原始安装包(.whl)在 wheels‑v1。
  • ✅ .venv 里只是硬链接,不占额外空间。

清理(别乱删)

  • 想清所有缓存:
    uv cache clean
    
  • 只清旧的、没在用的:
    uv cache prune
    

原文出处:/show_1GW3FtAJnRl2.html