使用 uv 清理缓存文件，最直接的方法是运行 uv cache clean 命令。该命令会清除本地下载的包、构建的 wheel 以及解析的元数据缓存。如果希望释放更多磁盘空间，可以配合 --all 参数彻底清空所有缓存内容；若只想清理特定项目的缓存，则需进入项目目录执行。执行后，uv 会在下次安装或解析时重新下载必要资源，确保环境一致性。
如何查看当前缓存占用情况
在清理之前，了解缓存占用了多少磁盘空间有助于判断清理的必要性。可以通过 uv cache dir 命令获取缓存目录的路径，然后结合系统工具（如 du 或文件管理器）查看具体大小。uv 本身没有直接显示大小的子命令，但可以通过列出缓存目录内容来间接评估。通常缓存位于用户主目录下的 .local/share/uv/cache（Linux/macOS）或 %LOCALAPPDATA%\uv\cache（Windows）。
uv cache dir
执行上述命令后，终端将输出缓存目录的绝对路径。例如：/home/user/.local/share/uv/cache。随后可在终端中使用 du -sh /path/to/cache 查看总大小。这一步骤不涉及修改任何配置，仅用于信息收集。
立即学习“Python免费学习笔记（深入）”；
清理缓存对现有虚拟环境的影响
清理缓存不会删除已安装的虚拟环境或其中已存在的包。虚拟环境中的包是独立于全局缓存的本地副本。然而，如果尝试重新激活或修复一个损坏的虚拟环境，uv 可能需要从缓存中恢复某些文件。若缓存已被清理，uv 将从远程索引重新下载所需包，这可能导致短暂的延迟。因此，建议在网络稳定且时间充裕时执行清理操作，以避免因重新下载而引发的等待。
uv venv .venv uv pip install requests uv cache clean --all uv venv .venv --clear
上述代码演示了创建虚拟环境、安装包、清理缓存并重新创建虚拟环境的过程。注意 uv venv .venv --clear 会删除旧环境并重建，此时 requests 包需重新安装。此过程验证了缓存清理不影响已有环境，但会影响后续的安装效率。
基于 uv cache clean --all 的具体问题：是否影响项目依赖锁定文件？
运行 uv cache clean --all 不会影响项目中的依赖锁定文件（如 uv.lock）。锁定文件记录的是精确的包版本和哈希值，存储在项目中，与本地缓存无关。清理缓存仅移除本地下载的中间文件和二进制包，不会触碰项目配置文件。因此，开发者可以放心执行全量清理，无需担心破坏项目的依赖关系定义。
