会生成独立的 uv.lock 文件，但不会修改 pyproject.toml；uv lock 默认读取 pyproject.toml 中的依赖声明并解析生成含精确版本、哈希及平台标记的锁文件，用于确保环境可重现。
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。
- 用
--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 动态解析依赖，可能导致版本漂移。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
正确做法是统一工具链：
- 用
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 是否稳定
