先说几个核心判断：ThinkPHP模型层的cache()方法与缓存标签机制没有任何关联；大量开发者被它的参数名称误导，以为传入一个字符串就能当作标签使用——实际上那仅仅是缓存键名称。要实现真正的标签缓存功能，必须主动绕过模型层，借助Cache::tag()自行存储序列化数据，而且这项操作还受限于缓存驱动，只有File和Redis能够正常支撑。

模型cache()方法虽然用起来很顺手，但它所谓的“缓存”标签能力几乎是一个天生的误解。请看这行代码：

$user = User::where('id', 1)->cache('user_1')->find();

传进去的这个'user_1'，你猜结果怎样？它真的仅仅是一个键名，和标签（tag）没有任何实际关联。它不会在底层被打上任何标签，也别指望通过Cache::tag('user')->clear()来清除它。模型的cache()底层走的是普通缓存写入流程，根本没有调用tag()方法。

模型 cache() 方法完全不涉及标签功能

更让人头疼的是，即便你在配置中写入了['tag' => 'user']，模型也完全不理会——cache()的第二个参数只接收整数（过期秒数）或null，数组参数会被直接忽略。如何验证？直接查询Redis，或者翻看runtime/cache/目录下的文件内容，你会发现缓存值里根本找不到任何标签元信息。后果显而易见：你满怀信心地调用Cache::tag('user')->clear()来清除标签，结果模型一查，数据仍然是那个陈旧的缓存。

真正支持标签的正确用法：手动序列化 + Cache::tag()

想要实现“查询一次、打上标签、批量清除”的完整操作链路，必须放弃模型缓存，自行构建处理逻辑。核心思路很简单，分两步走：先把数据查出来并转为数组，再通过Cache::tag()存储进去。

• $key = 'user_profile_' . $id; —— 构造唯一键名，避免命名冲突
• $data = User::where('id', $id)->find()?->toArray(); —— 必须执行toArray()转换，直接缓存Collection对象会导致反序列化时报错
• Cache::tag('user')->set($key, $data, 3600); —— 这才是在缓存上正确打标签的标准操作
• 读取时也必须使用相同标签：Cache::tag('user')->get($key)，跨标签无法获取数据

必须特别留意的是：只有File和Redis驱动完整实现了TagSetInterface接口，像Apcu、Xcache这类驱动，调用tag()会静默退化为无标签缓存模式，执行清除操作也不会有任何效果。

按标签清除缓存时，这些操作都是无效的

很多人遇到缓存清理不掉的问题，多半是踩了下面这些常见误区：

• Cache::clear('user') —— 这实际上是在清除标识为'user'的缓存分组，并非标签清理
• cache('key', null, ['tag' => 'user']) —— cache()辅助函数根本不识别['tag' => ...]这种数组参数
• Cache::tag('user')->delete('key') —— delete()只针对单个键进行删除，要清空全部必须使用clear()
• php think clear —— 该命令默认不会触发标签清理，除非当前驱动在TP6+中主动实现了标签感知机制（例如Redis按前缀扫描，但并不按标签清理）

唯一可靠的方式就是Cache::tag('user')->clear()，而且前提条件是：这个缓存确实是通过Cache::tag('user')->set()写入的。否则调用了也是白费力气。

多级缓存和跨驱动场景下标签无法共享

另一个容易出问题的地方：标签只在当前缓存store实例内部有效。比如你配置了两个Redis store：redis和redis_session，虽然都使用了tag('user')，但它们之间彼此独立，互不影响。

• 用Cache::store('redis')->tag('user')->set(...)写入的数据，只能被Cache::store('redis')->tag('user')->clear()清除
• 切换store后调用Cache::tag('user')->clear()，清除的其实是默认store中的内容，而不是你心里想的那一个
• 在TP6/TP7中，config/cache.php里的default配置项决定了Cache::tag()操作指向的目标store。别想当然地认为它会自动匹配你model查询所使用的store

最容易被忽略的一点：缓存标签功能完全取决于驱动层的具体实现，而驱动如何支撑、是否支持，都需要仔细查看config/cache.php配置。不搞清楚配置就贸然执行缓存清理，大概率会清错位置，或者根本清理不掉。