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。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确认所有依赖都能从同一源下载（推荐统一用
--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 重新解析完整依赖树。但你可以控制“哪些输入变”来间接达成目标：
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 把需锁定版本的直接依赖写进
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 临时装的开发工具。
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
实操建议：
立即学习“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 版本下无交集版本。
实操建议：
立即学习“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），后面就容易突然崩掉。
