用claude code写的EdgeOne CDN 智能缓存插件

这门课的核心其实很窄：一个体量约 10 KB 的 EdgeOne CDN 智能缓存插件，从需求产生到实现逻辑的完整拆解。作者是用 Claude Code 写出来的，整个资料包只包含最终的插件代码，没有视频、没有大段理论铺垫。所以先给结论——它适合已经知道 CDN 缓存是怎么回事、但手头正好缺一个能直接用的 EdgeOne 缓存规则实现的人；如果你连「回源」「缓存键」「边缘节点」这些概念都还没建立，这份资料大概率会让你看得懂代码、却不知道为什么这么写。

它对应的真实工作场景

日常最典型的两类麻烦：一是站点接在腾讯云 EdgeOne 上，默认缓存策略太粗，静态资源命中率上不去，动态接口又被误缓存；二是想按文件类型、路径前缀、请求头做细粒度缓存控制，翻官方文档能写出来，但每次配置都要重来一遍，还容易在缓存键上出错。这个插件解决的就是第二类问题——把一套可复用的智能缓存判定逻辑封装起来，让它跟着请求自动决定该不该缓存、缓存多久、按什么维度区分缓存。

换句话说，它不是教你「CDN 是什么」的科普内容，而是针对已经在 EdgeOne 上跑业务、需要把缓存策略落地成代码的读者。

学完能独立做什么

• 读懂插件的判定流程：一个请求进来后，怎么一步步判断命不命中、走缓存还是回源。
• 按自己的站点结构调整缓存规则，比如给图片、脚本、样式设不同的过期时间，给接口路径设例外。
• 理解缓存键的组成，避免因为键设计不合理导致「该合的不合、该分的不分」，命中率上不去。
• 把插件接入自己的 EdgeOne 配置流程，并做基础的验证——改规则后看命中率和回源量的变化。

这里要提醒一句：代码量小，不代表上手零成本。EdgeOne 的配置入口、插件挂载方式这些环境相关的部分，资料不会替你补，需要你对照官方控制台自己走一遍。

资料适合的基础与用法建议

建议具备三样前提：能看懂 JavaScript 或至少能读懂条件分支和对象结构；对 CDN 缓存的基本概念不陌生；手上有可测试的 EdgeOne 环境。三者缺一，建议先补缺的那块再回来。

用法上不建议从头顺读。更高效的做法是：先打开代码，找到决定缓存与否的那个判定函数，把它当成入口；再顺着缓存键的构造往回看；最后才去看过期时间和边界处理。这样一轮下来，你对整份资料的掌控会比线性阅读快得多。

关于它的定位

这是一个「工具型」资料，不是体系课。它的价值在于给你一个能跑、能改、体量小到可以完整读完的参考实现，而不是覆盖 EdgeOne 的全部能力。把它当作你自己缓存策略的起点，改到贴合业务，比指望它开箱即用更现实。如果你的需求只是「把默认缓存开大一点」，那可能用不上它；如果你已经在为细粒度规则反复调试，那这 10 KB 值得花一个下午读完。