必须先彻底清理再重建uv项目环境：执行uv cache clean清缓存，手动删.venv/、uv.lock和.python-version；用uv python list查版本，必要时install并pin；再uv init、uv python pin、uv venv --clear后uv sync。

彻底卸载并重建uv项目环境

当你遇到依赖冲突、uv.lock文件损坏、Python版本错配，或想从零开始重置整个项目环境时，必须先完整清理旧环境再重建，否则残留的缓存、锁文件或已安装包会干扰新环境行为。

清除全部残留文件和缓存

在项目根目录（含pyproject.toml的文件夹）中执行：

uv cache clean

这一步会清空全局下载缓存，避免uv复用损坏的wheel包。注意：【uv cache clean 不会影响已安装的Python解释器】，只删下载过的包缓存。

手动删除以下三项：

.venv/ 目录（虚拟环境本体）

uv.lock 文件（依赖锁定快照）

.python-version 文件（如果存在，它会强制绑定Python版本）

确认Python解释器状态

运行 uv python list 查看当前可用Python版本列表。

若你之前用 uv python install 安装过特定版本（如3.10.20），该版本仍保留在本地，无需重复下载；若该版本已丢失或你想换版本，执行 uv python install 3.12 → uv python pin 3.12 重新绑定。

重建项目环境

第一步：重新生成项目骨架（保留原有pyproject.toml内容）

uv init --name myproject

第二步：指定并锁定Python版本（关键！否则uv可能选错默认版本）

uv python pin 3.12

第三步：创建干净虚拟环境并同步依赖

uv venv --clear → uv sync

【--clear 参数不可省略】，它确保覆盖旧的 .venv 而非增量更新，避免隐藏的旧包残留。