改了样式前台不变，我先查 enqueue
样式我改了三遍，浏览器硬刷新也没用。看网页源代码才发现，head 里请求的根本不是我改的那个文件。 先看实际发出去的地址 前台右键看源代码，搜主题目录名。常见就两种：链接 404，或者指到父主…
2026年10月
按发布时间归档的文章列表。
年
子主题函数没执行，多半是 Template 写错了
子主题在后台能启用，前台函数却像完全没写过。我第一次碰到，盯着 CSS 改了半小时，后来才发现 functions.php 根本没被加载。 Template 填的是目录名 style.css …
白屏别先改模板，我一般先看 debug.log
主题一启用就白屏，我现在不先翻 header.php。十有八九是 functions.php 里先炸了，请求还没走到模板。 三个常量，设错一个就两眼一抹黑 改的是站点根目录的 wp-confi…
Z-Blog 保存文章，Core 和 Succeed 别挂反
我上次给保存文章加了个小动作，挂在 Filter_Plugin_PostArticle_Succeed 上改字段。后台提示保存成功，刷新一看，字段还是旧的。不是钩子没跑，是我挂晚了。 这两个钩…
主题模板越来越像脚手架，我反而写不动了
上周想给一个客户站改个列表页标题样式，结果打开主题目录一看，六个子模板、两层 include、一堆 function 调用。改一行 HTML，得先顺着调用链往上追三层才知道这段到底在哪渲染。 …
迅睿CMS 模板里读自定义字段值，dr_share_cat_value 和直接写不一样
分类页要显示一段 SEO 描述，我在后台给分类加了自定义字段 seo_desc，模板里手写 {$cat.seo_desc}，输出空白。改了半小时模板才发现，字段是加上了，但取值方式不对。 全局…
register_rest_route 注册了接口，访问一直返回 404
接口地址自己拼得挺顺，浏览器一敲却是 404，连 rest_no_route 的错误 JSON 都没给。这种一般不是权限问题，是路由压根没挂上——因为你在错误的时间注册了它。 挂 rest_a…
Z-Blog 主题取缩略图，我找了半天没这个属性
想在列表页给每篇文章配张缩略图，我下意识去翻 $article->Thumb。翻不到。Z-Blog 的 Post 对象里没有这个东西，也没有 WordPress 那套「特色图像」，得自己想办法…
WordPress 主题越来越像应用，调试成本却没人提
昨天帮人看一个主题，functions.php 一千二百多行，inc 目录塞了十九个文件。我就想改个文章列表的分类显示，找了四十分钟才定位到。这事不新鲜，但我觉得方向有点问题。以前的主题是模板…
WordPress 自定义循环里取不到分类，the_post 忘调了
照手册写了个 WP_Query，正文标题能出来，get_the_category() 返回空数组。不报错，就是不显示。查了一个多小时。have_posts() 只挪游标，the_post() …