如有疑问，就删除 uv.lock 文件

自从切换到 Python 3.15 后，我偶尔会遇到令人困惑的 Python 依赖错误，而我不得不记住的规则是：如有疑问，就删除 uv.lock 文件。

我的大多数项目都是库，不包含 uv.lock 文件，因为库依赖为使用它的其他任何东西锁定版本是失礼的。

运行 uv run pytest 等往往会留下 uv.lock 文件，这些文件列在 .gitignore 中，因此不会被提交到我的仓库。

但是……有时那个 uv.lock 会固定一个尚未有 Python 3.15 wheel 的依赖版本。

今天早些时候的一个例子：

error: Failed to build `watchfiles==1.1.1`
cause: Call to `maturin.build_wheel` failed
error: the configured Python interpreter version (3.15) is newer than PyO3's maximum supported version (3.14)

删除该文件并再次运行 uv run pytest 通常可以解决问题。

Simon Willison 在切换到 Python 3.15 后遇到依赖构建错误，经验规则是删除本地 uv.lock 并重跑测试；该做法对库项目排障有用，但删除锁文件会带来版本漂移风险。

• Simon Willison 在切换到 Python 3.15 后遇到依赖构建错误，经验规则是删除本地 uv.lock 并重跑测试；该做法对库项目排障有用，但删除锁文件会带来版本漂移风险。
• 原贴提到：I've been getting the occasional confusing Python dependency error since
• 来源：simonwillison.net

这是什么信号：这不是新工具发布，而是一条来自 Simon Willison 的实战排障经验：切换到 Python 3.15 后，uv.lock 可能把依赖固定到尚未提供 3.15 wheel 的版本，触发构建失败；示例是 watchfiles==1.1.1 在 maturin.build_wheel 阶段失败，错误指出 Python 3.15 高于 PyO3 支持的最高版本 3.14。作者的临时规则是删除 uv.lock 并重新运行 uv run pytest。

为什么重要：它揭示了“锁文件提升可复现性”与“新 Python 版本生态未跟上”之间的张力。库项目通常不提交 uv.lock，以免替下游锁定版本；但本地运行测试会生成锁文件，若它缓存了不兼容版本，就会让排障变得隐蔽。对使用 uv 管理 Python 项目的开发者，这类错误看起来像构建工具问题，实际可能是锁文件中的版本与解释器版本不匹配。

对谁有价值：正在迁移到 Python 3.15 的 Python 开发者、维护库项目的作者、使用 uv 跑测试的团队，以及遇到 maturin/PyO3 构建错误的人。

可以怎么行动：先确认 uv.lock 是否被 .gitignore 忽略且未提交；若错误指向某个依赖缺少新解释器 wheel，可删除本地 uv.lock 后重跑 uv run pytest，让 uv 重新解析依赖；如果仍失败，再检查该依赖及其构建后端是否支持 Python 3.15。对库项目，保持不提交 uv.lock 的习惯，同时把“删除本地锁文件重跑”写成排障步骤。

风险或限制：删除 uv.lock 不是万能修复，它会触发依赖重新解析，可能带来版本漂移；对应用项目，锁文件是部署可复现性的关键，不应随意删除。该经验也依赖具体依赖和构建后端是否已发布兼容 wheel，不能替代对版本约束和构建链的检查。

这条内容的真正价值，不只是“有人发布了一个新功能”，而是它揭示了 simonwillison.net 背后的产品方向、工作流变化或竞争信号。对 OPC 来说，这种信息可以转化成持续追踪的栏目选题。

如果把《如有疑问，就删除 uv.lock 文件》放到你的内容系统里，它最大的价值在于帮助读者更快看懂“为什么值得关注”，而不是只看到一条碎片化动态。

• Simon Willison 原帖