pip-compile生成的requirements.txt含哈希但安装失败，因源不一致、wheel缺失或平台不匹配导致校验失败；解决需统一源、禁用哈希或显式指定可信源与fallback。
为什么 pip-compile 生成的 requirements.txt 里有哈希但安装失败？
因为默认启用 --generate-hashes 后，pip-compile 会为每个包写入 --hash 行，但 pip 安装时若遇到源不一致（比如 PyPI 和私有镜像混用）、wheel 缺失或平台不匹配，就会校验失败并报错：ERROR: Hashes not found for package 或 Hash mismatch。
实操建议：
- 确认所有依赖都能从同一源下载（推荐统一用
--index-url https://pypi.org/simple/，避免镜像缓存差异） - 临时禁用哈希校验：在
pip install -r requirements.txt时加--no-deps --force-reinstall并删掉requirements.txt中的--hash行（不推荐长期用） - 更稳妥的做法是：编译时显式指定可信源 + 允许 fallback，例如：
pip-compile --index-url https://pypi.org/simple/ --find-links https://your-private-index/simple/ --trusted-host your-private-index
如何让 pip-compile 只更新某个子依赖而不重刷整个树？
pip-compile 本身不支持“局部更新”，它总是从 requirements.in 重新解析完整依赖树。但你可以控制“哪些输入变”来间接达成目标：
实操建议：
- 把需锁定版本的直接依赖写进
requirements.in，如requests==2.31.0；把不想被自动升级的间接依赖（如urllib3）用pip-compile --no-upgrade配合--pre控制范围 - 若只想升一个子依赖（比如
click），先手动改requirements.in加一行click>=8.1.0，再运行pip-compile --upgrade-package click - 注意：
--upgrade-package仅对requirements.in中已声明的包生效；未声明的子依赖（如flask带来的itsdangerous）只能靠整体重编译 +--upgrade或人工 pin 到requirements.in
pip-sync 为什么会删掉我手动 pip install 的包？
pip-sync 的设计逻辑就是“以 requirements.txt 为唯一真相”，它会卸载所有不在该文件里的包——包括你用 pip install pytest 临时装的开发工具。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
实操建议：
- 开发时别混用
pip install和pip-sync；所有依赖必须进requirements.in（或拆成dev.in） - 用多文件管理：建
requirements.in（生产依赖）、dev.in（含-r requirements.in+pytest等），再分别编译：pip-compile dev.in→dev.txt，然后pip-sync dev.txt - 执行前加
--dry-run看清将删哪些包；必要时用--skip-requirements-regex排除特定包名（慎用，破坏一致性）
CI/CD 中运行 pip-compile 失败，提示 Could not find a version that satisfies...
这通常不是网络问题，而是 pip-tools 解析时发现约束冲突：比如 django>=4.2 和 djangorestframework 在当前 Python 版本下无交集版本。
实操建议：
- 检查
requirements.in是否存在隐式冲突（尤其带!=或宽泛范围如requests>=2.0） - 用
pip-compile --verbose查看具体卡在哪一包、尝试了哪些版本 - 临时降级 pip-tools 版本（如从 7.x 回退到 6.14.0），新版 resolver 更严格，老项目容易暴露历史遗留约束问题
- Python 版本不匹配也会触发：确保 CI 中的
python -V与本地一致，并在requirements.in顶部加注释说明，例如# python-version: 3.11
依赖树的“整洁”不在于没报错，而在于每次 pip-compile 输出都可复现、每次 pip-sync 执行都只做预期变更——中间任何一步绕过机制（比如手改 requirements.txt），后面就容易突然崩掉。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
