0

0

Python CI 缓存的优化层级

舞夢輝影

舞夢輝影

发布时间:2026-02-16 15:07:03

|

617人浏览过

|

来源于php中文网

原创

pip缓存未生效主因是默认不校验wheel兼容性,如python 3.11构建的wheel在3.12环境被无视;应加--prefer-binary、升级pip≥22.2,并合理设计cache key包含python版本与requirements哈希。

python ci 缓存的优化层级

pip install 时为什么缓存没生效?

CI 中 pip install 反复下载包,不是因为没配缓存,而是 pip 默认不校验本地 wheel 缓存是否与当前环境兼容。比如你用 Python 3.11 构建的 wheel,在 3.12 环境里会被无视——哪怕只是 minor 版本差,pip 也认为“不安全”,直接重下源码重编译。

实操建议:

立即学习Python免费学习笔记(深入)”;

  • 在 CI 脚本中显式加 --prefer-binary,强制优先用缓存 wheel,而非退化到 sdist
  • 确保 pip 版本 ≥ 22.2(旧版对多平台 wheel 支持弱),可用 python -m pip install --upgrade pip 预升级
  • 若用 Poetry 或 Pipenv,它们默认绕过 pip 的 wheel 兼容检查,但会引入自己的 lock 文件依赖层,缓存粒度变粗、失效更隐蔽

GitHub Actions 中 cache action 的 key 怎么写才不翻车?

缓存 key 写成固定字符串(如 "pip-cache")等于没缓存;写成哈希整个 requirements.txt 又太敏感——换行符、注释、空格微调都会导致缓存 miss。

实操建议:

立即学习Python免费学习笔记(深入)”;

  • hashFiles('**/requirements*.txt') 而非单个文件,覆盖 requirements-dev.txt 等变体
  • 把 Python 版本纳入 key:python-${{ hashFiles('**/requirements*.txt') }}-${{ matrix.python-version }}
  • 避免把 pip list 输出或 venv 路径塞进 key——这些是结果,不是输入,会导致循环依赖

poetry install 比 pip install 慢,缓存能救回来吗?

能,但得拆开看:Poetry 的 poetry install 本身不读 pip 缓存,它走自己的 ~/.cache/pypoetry;而它的 lock 文件解析和虚拟环境重建逻辑,比 pip 更重。

极品HTML5网络建站公司模板源码(包含源文件)3.0
极品HTML5网络建站公司模板源码(包含源文件)3.0

1、架构轻盈,完全免费与开源采用轻量MVC架构开发,兼顾效率与拓展性。全局高效缓存,打造飞速体验。 2、让简洁与强大并存强大字段自定义功能,完善的后台开关模块,不会编程也能搭建各类网站系统。 3、顶级搜索引擎优化功能纯静态、伪静态,全部支持自由设置规则,内容、栏目自由设置URL格式。 4、会员、留言、投稿、支付购物神马一个不能少不断升级完善的模块与插件,灵活的组装与自定义设置,满足你的多样需求。

下载

实操建议:

立即学习Python免费学习笔记(深入)”;

  • CI 中优先用 poetry install --no-root(跳过项目包安装),只装依赖,省掉一次 build
  • poetry export -f requirements.txt | pip install -r /dev/stdin 替代纯 poetry 流程,直接复用 pip 缓存层
  • 注意 Poetry 1.4+ 默认启用 virtualenvs.in-project = true,导致每次缓存路径含随机 hash,必须显式设为 false 并固定 virtualenvs.path 才能稳定命中缓存

缓存层级叠太多反而拖慢 CI?

是的。比如同时配置了:pip 缓存 + Poetry 缓存 + venv 目录缓存 + .pytest_cache 缓存——其中 venv 和 pytest 缓存几乎从不复用,却要花数秒上传下载,净增耗时。

实操建议:

立即学习Python免费学习笔记(深入)”;

  • 只缓存真正“构建代价高且输入稳定”的东西:pip wheel 缓存、Poetry 的 artifacts 子目录(不是整个 cache)、~/.cache/pre-commit
  • 跳过缓存 __pycache__.mypy_cache.pytest_cache——这些是运行时产物,生命周期短,且大小波动大
  • actions/cache@v4restored: ${{ steps.cache.outputs.cache-hit == 'true' }} 做条件判断,后续步骤可据此跳过冗余 install

缓存不是越多越好,关键在“哪些东西变了才该失效”。Python 版本、依赖声明、构建工具版本,这三者任何一个动了,整个依赖缓存就该刷新——其余都只是干扰项。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

348

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

425

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

786

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

356

2025.07.23

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

552

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

216

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1552

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

640

2023.11.24

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

145

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号