Anki Cloze 验证机制完整指南填空不生效时快速定位问题的自查清单【免费下载链接】ankiAnki is a smart spaced repetition flashcard program项目地址: https://gitcode.com/GitHub_Trending/an/ankiAnki 的 Cloze完形填空是背词效率最高的卡片类型之一但不少新手都栽过跟头明明照着教程写了{{c1::...}}卡片却纹丝不动或者一条笔记只生成了 1 张卡片预期中的 3 张凭空消失。别急着删库重来——这些问题背后其实是 Anki 一套安静工作的 Cloze 验证逻辑。这篇文章把这套机制翻出来给你看最后附一份保存卡片前的逐条自查清单。系统是怎么认出你的 Cloze 标记的Anki 并不猜你写的是不是填空它靠的是严格的模式匹配找到{{c开头、}}结尾的片段中间的序号必须是数字或逗号分隔的数字比如1、1,2序号和填空内容之间必须用::分隔每个合法标记都会被登记进一张序号集合集合里有几个不同的数字就拆出几张卡片渲染时按当前卡片的序号决定这块内容该藏起来显示[...]还是亮出来。核心解析逻辑在 rslib/src/cloze.rs 中而这条笔记到底算不算 Cloze 笔记的判断入口则在 pylib/anki/models.py 的cloze_fields()。理解了这四步后面所有的诡异行为都能对号入座。下面这张图是 Anki 的标准添加界面填空字段就写在这里我的 Cloze 标记为什么没生效最常见 3 种原因排查时别乱改按症状 → 原因 → 自查动作走一遍基本三分钟出结果。症状一整段标记原样显示卡片一张都没拆多半出在序号上。{{c::答案}}没写数字、{{cX::答案}}写成了字母都属于无效标记Anki 会直接把它当成普通文字渲染。还有一个隐蔽情况序号0是合法数字但c0会被整个忽略——不生成卡片也不隐藏内容字段里却留着一串看起来像那么回事的标记最容易让人怀疑人生。自查动作把字段里所有{{c后的内容过一遍确认每一位都是 1 及以上的正整数。症状二从某个位置开始后面的文本全乱了这是典型的未闭合标记。{{c1::答案少了结尾的}}时Anki 的解析器找不到配对这个开口会一直影响后续内容的归属看起来就像标记从奇怪的位置开始。反过来多写一个}}也不报错——解析器发现闭合符外面没有对应的开口时会把它当普通文本}}原样输出。自查动作数一下字段里{{和}}的数量是否相等不确定的话从最后一个正常显示的词往后逐段删改定位。症状三嵌套写了一堆最里面那层消失了Cloze 支持嵌套但层级上限是 10 层rslib/src/cloze.rs 中的栈深度限制。超过的部分会被静默丢弃不报错。日常使用根本用不到 5 层以上如果你发现自己写了三层嵌套还在往上加先停一下——十有八九是结构拆得太碎了换个写法通常能一层解决。自查动作打开字段用括号配对的方式从上往下逐层核对确认每层{{cX::...}}都在自己的}}里闭合。进阶配方一个标记多张卡片基础 Cloze 是一个序号一张卡下面两个配方能让同一个字段干更多活。配方一Cloze 多序号——一处内容同时挖空在两张卡里场景同一个知识点你想从两个角度各考一次又不想把内容抄两遍。把一个标记的序号写成逗号分隔的形式即可{{c1,2::光反应}}发生在类囊体膜上把水分解为{{c1::氧气}}并产生{{c2::ATP}}。系统会按集合里的不同序号拆出 2 张卡卡片 1[...]发生在类囊体膜上把水分解为氧气并产生ATP。卡片 2[...]发生在类囊体膜上把水分解为氧气并产生[...]。序号会自动去重{{c1,1,2::x}}和{{c1,2::x}}效果一样逗号后留空{{c1,,2::x}}也能正常跳过空项。配方二Cloze 嵌套——大挖空里套小挖空场景你想分别考整段结构和结构中的关键一环。把小标记直接写进大标记内部{{c1::光合作用的{{c2::暗反应}}阶段在叶绿体基质中进行}}拆卡结果卡片 1[...]在叶绿体基质中进行整段被挖掉内外一起藏卡片 2光合作用的[...]阶段在叶绿体基质中进行外层照常显示只挖内层注意外层标记还能加提示{{c1::...::提示词}}会把[...]变成[提示词]方便给考生留线索。嵌套建议控制在 3 层以内读起来清爽渲染也稳定。图像遮挡小专题Anki 图像遮挡怎么用背解剖图、地图、电路图时纯文字 Cloze 帮不上忙。Anki 提供了图像遮挡Image Occlusion机制把普通的{{cX::...}}标记换成image-occlusion:前缀就能在图片上画出遮挡区。标记格式完整解析见 rslib/src/image_occlusion/imageocclusion.rs{{c1::image-occlusion:rect:left10:top20:width30:height40}}参数含义很直白rect是形状可选矩形、椭圆ellipse需加rx/ry或文本框textleft/top是坐标width/height是尺寸单位是像素。效果如图中所示问题面遮挡区域显示为可点击的色块答案面高亮显示位置实际操作中你不需要手写这些参数——Anki 自带图像遮挡编辑器直接在图上框选区域即可自动写出标记编辑器支持多种标注模式适用场景很典型医学解剖图遮住器官名称考认读、地图遮住国家/省份考定位、电路与流程图遮住元件考功能。多序号在图像遮挡上同样有效——{{c1,2::image-occlusion:...}}会把同一个遮挡区挂到两张卡上。保存卡片前的 5 项自查清单每次存卡前花 10 秒过一遍90% 的 Cloze 事故在保存前就拦住了每个标记都是{{c数字::内容}}形式序号是 1 或更大的正整数没有c0、c::、cX::{{和}}数量相等每个标记都完整闭合嵌套不超过 3 层硬上限 10 层超过会被静默丢弃卡片数量符合预期字段里出现了几个不同序号多序号按逗号拆开算就该有几张卡图像遮挡标记里left/top/width/height等参数齐全且为数字。如果某条笔记的卡片数量长期对不上可以用 Anki 自带的数据库检查兜底入口逻辑在 qt/aqt/dbcheck.py它会把结构异常批量扫出来。Cloze 验证机制说白了就是格式严格、错误静默它不会弹窗骂你只会按自己的规则把内容原样输出。把上面的规则内化成肌肉记忆填空卡片就能稳定地为你工作。【免费下载链接】ankiAnki is a smart spaced repetition flashcard program项目地址: https://gitcode.com/GitHub_Trending/an/anki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考