uv默认强制校验PyPI元数据中的sha256哈希,本地计算值不匹配则立即中断安装并报错;该机制无需配置、不可绕过,能从源头阻止CDN劫持、镜像污染或包被恶意替换。

uv 本身不提供类似 safety 或 pip-audit 那样的 CVE 漏洞扫描能力,它不做运行时依赖安全检查;但它的哈希验证和锁定机制能从源头阻止恶意包注入,这是更底层、更可靠的安全保障。
uv 的哈希验证如何防止依赖被篡改
uv 默认强制校验每个下载包的哈希值,且只信任 PyPI 元数据中声明的 sha256 值。一旦本地计算出的哈希与元数据不一致,安装直接中断并报错:
error: Failed to download and verify package `requests-2.31.0-py3-none-any.whl`: hash mismatch
这意味着:即使攻击者劫持了 CDN、污染了镜像源,或 PyPI 上某个包被恶意替换,uv 都会拒绝安装。
- 该行为无需额外配置,
uv pip install或uv sync均默认启用 - 禁用它需显式加
--no-verify-hashes(不建议,CI 中应禁止) - 哈希信息来自 PyPI 的 JSON API,不是本地
requirements.txt或人工维护的列表,无法被项目方绕过
为什么 uv.lock + uv sync 比 requirements.txt 更安全
传统 requirements.txt 只记录包名和版本号,不绑定具体发行版(wheel/sdist)、平台标签或哈希。同一行 requests==2.31.0 在不同机器上可能拉到不同构建产物——尤其是当作者发布了多个 .whl(如 manylinux vs musllinux)时。
uv.lock 则精确记录:
Python uv 0.12.20 是 Astral 开发的 Python 包与项目管理工具,支持依赖解析、虚拟环境、Python 版本及项目锁文件管理。本下载包适用于 Windows x64,解压后可使用 uv 命令。
- 每个包的完整 URL 和
sha256哈希 - 适用的
platform和python_version约束 - 所有间接依赖(transitive deps)的版本与哈希
执行 uv sync 时,uv 严格按 uv.lock 中的哈希还原环境,跳过任何解析环节——这消除了“相同版本号但不同二进制”的供应链风险。
如何配合外部工具做 CVE 扫描
若你确实需要知道当前依赖是否存在已知漏洞,uv 不替代专用审计工具,但能帮你干净地导出可审计的输入:
- 用
uv pip freeze --all输出带哈希的完整依赖列表(比pip freeze多一列hash) - 用
uv export --format=pyproject生成符合 PEP 621 的pyproject.toml片段,供pip-audit解析 - 推荐组合:
uv pip install pip-audit && pip-audit -r (注意:audit 不校验哈希,仅查 CVE 数据库)
关键点在于:uv 确保你 audit 的是真实安装的包,而不是靠版本号猜出来的包。
真正容易被忽略的是:哈希验证只对「已知来源」有效。如果你在 pyproject.toml 中用了 git+、file:// 或私有索引,uv 无法获取其官方哈希,此时需自行确保来源可信——这部分安全责任不在 uv 范围内。










