讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

Python mypy 的增量检查与缓存

大静君_6998

大静君_6998

发布时间:2026-02-23 19:17:43

|

937人浏览过

|

来源于php中文网

原创

增量检查未生效的根本原因是缓存被绕过:修改pyproject.toml/mypy.ini配置、__init__.py等顶层模块,或使用--follow-imports=normal但存在未安装包,均触发全量重检;可通过--verbose日志、.mypy_cache目录及二次运行耗时验证缓存是否工作。

python mypy 的增量检查与缓存

增量检查为什么没生效?

mypy 默认开启增量检查,但实际不提速,大概率是缓存被绕过了。根本原因不是它坏了,而是你改了某些触发全量重检的文件或配置。

  • pyproject.toml 或 mypy.ini 里修改了 plugins、disallow_untyped_defs 等影响类型语义的配置项,mypy 会丢弃整个缓存
  • 修改了 __init__.py 或任何被其他模块 import 的顶层模块,它会重新计算依赖图,很多文件被迫重检
  • 用了 --follow-imports=normal(默认值),但实际项目里有本地未安装的包,mypy 会退回到慢速解析模式,缓存失效

怎么确认缓存是否在工作?

别猜,直接看输出和文件系统。mypy 不会主动告诉你“本次用了缓存”,得自己验证。

  • 加 --verbose 运行一次,观察日志里有没有类似 cached: module_x, module_y 的行;没有就说明没走缓存路径
  • 检查 .mypy_cache/ 目录是否存在且有内容,特别是子目录名是否对应你的 Python 版本(如 3.11)
  • 改一行无关代码(比如注释),再跑 mypy --show-traceback,如果报错位置和上次一样、耗时明显低于首次,基本可判定缓存生效

mypy --incremental 是不是必须加?

不是。从 mypy 0.900 开始,--incremental 已是默认行为,显式加上反而容易让人误以为它是“开关”。真正影响缓存行为的是以下几件事:

Biopython
Biopython

全面的分子生物学工具集。适用于序列操作、文件解析(FASTA/GenBank/PDB)、系统发育分析,以及通过 Bio.Entrez 以编程方式访问 NCBI/

下载
  • 确保没传 --no-incremental —— 这个 flag 会强制禁用所有缓存逻辑
  • 避免混用 mypy 和 mypyc,后者有自己的缓存结构,会污染 .mypy_cache/
  • CI 环境里注意清理策略:有些流水线每次清空 workspace,导致缓存永远建不起来;建议保留 .mypy_cache/ 目录(但别提交到 git)

缓存文件能手动删吗?

能,而且有时必须删。缓存不是坚不可摧的,它会因类型信息不一致而卡住,表现是:明明改对了类型,mypy 还报老错。

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

  • 最安全的清理方式是 rm -rf .mypy_cache/,不要只删部分子目录
  • 如果只想清特定模块,可以用 mypy --clear-cache,但它只清内存映射,不删磁盘文件,效果有限
  • Python 升级后(比如从 3.11 切到 3.12),旧缓存目录不会自动废弃,mypy 可能读错版本对应的 cache,此时必须手动删

缓存机制本身不复杂,但它的边界条件很具体——它只信任“没动过”的文件和“没变过”的配置。一旦其中一环松动,它就退回全量模式,而且不提醒你。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

7679

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2100

2023.07.06

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

1254

2023.07.24

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

4977

2024.04.09

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

4961

2024.04.09

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

100

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

60

2026.11.12

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

160

2026.11.06

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn