Python uv如何进行版本锁定（Locking）-Python教程-PHP中文网

会生成独立的 uv.lock 文件，但不会修改 pyproject.toml；uv lock 默认读取 pyproject.toml 中的依赖声明并解析生成含精确版本、哈希及平台标记的锁文件，用于确保环境可重现。

python uv如何进行版本锁定（locking）

uv lock 会生成 pyproject.toml 对应的 uv.lock 文件吗？

不会自动写入 pyproject.toml，但会生成或更新独立的 uv.lock 文件。这是 uv 的默认行为：运行 uv lock 后，依赖解析结果会写入当前目录下的 uv.lock（如果存在则覆盖），而 pyproject.toml 本身只负责声明原始依赖（dependencies、requires-python 等），不包含版本号锁定信息。

常见错误现象是执行 uv lock 后没看到变化——其实锁文件已生成，只是没被 Git 跟踪或被 .gitignore 忽略了。检查是否漏加 uv.lock 到版本控制中。

uv lock 默认读取 pyproject.toml 中的 [project.dependencies] 和 [build-system]
若项目含 [project.optional-dependencies]，需显式用 --extra dev 等参数触发对应组的解析
锁文件格式为 TOML，含哈希校验、Python 版本约束、平台标记（如 manylinux_2_17_x86_64），比 pip-tools 的 requirements.in 更细粒度

如何让 uv lock 使用特定 Python 版本或平台？

uv 的锁过程默认使用当前运行环境的 Python 版本和平台，但生产环境往往需要预设目标环境。必须通过命令行参数显式指定，否则锁文件可能在 CI 或不同机器上解析出不一致的 wheel。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

用 --python-version 3.11 强制指定解释器版本（影响 python_version 环境标记）
用 --platform manylinux2014-x86_64 指定目标平台（影响 platform_system、platform_machine 等标记）
组合使用时，例如 uv lock --python-version 3.12 --platform win-amd64，确保锁文件匹配 Windows + Python 3.12 环境
不指定时，uv 会从 requires-python 推断最小版本，但不会主动降级或跨平台模拟

uv.lock 被修改后，pip install -e . 会用它吗？

不会。uv 的锁文件仅对 uv 命令族生效（uv pip install、uv sync、uv run）。传统 pip install -e . 完全忽略 uv.lock，仍按 pyproject.toml 动态解析依赖，可能导致版本漂移。

正确做法是统一工具链：

用 uv sync 替代 pip install -e .：它会读取 uv.lock 并安装精确版本到当前环境
开发时推荐 uv sync --dev（自动包含 optional-dependencies 中的 dev 组）
若必须用 pip，可先用 uv export -r requirements.txt 导出兼容格式，再 pip install -r requirements.txt
注意：uv export 默认不导出 hashes，加 --with-hashes 才能保证 pip 安装时校验

为什么 uv lock 后某些包版本和预期不符？

根本原因是 uv 优先满足约束兼容性而非“最新版”，且默认启用 PEP 665 兼容逻辑（如跳过已弃用的包、尊重 python-requires、避免轮子冲突）。容易被忽略的点是：它不遵循 pip 的 --pre 行为，也不默认启用 pre-release 包。

检查 pyproject.toml 中是否有模糊约束，例如 "requests>=2" —— uv 可能选 2.31.0 而非 2.32.0，只要前者满足所有传递依赖
想固定某包版本？在 pyproject.toml 中写死，如 "requests==2.31.0"，uv lock 会严格遵守
遇到 No solution found 错误，大概率是约束冲突（比如两个依赖分别要求 click 和 <code>click>=8.1），用 uv lock --explain 查看冲突路径
锁文件里出现 source = { git = "..." } 表示该包来自 Git 仓库，此时 uv 不会生成 hash，需确认 commit 是否稳定