迭代式建主题(71):常见坑合集

作者: admin 分类: wordpress主题制作教程 发布时间: 2026-11-05 14:00

这一篇没有新知识,只是把这 70 篇里反复出现、以及我自己踩过的坑列一遍。遇到问题先扫一眼这张表。

模板与文件

现象 原因
改了模板没生效 缓存没清;或者改的是父主题,实际在用子主题
上传主题提示「缺少 style.css」 压缩包多套了一层文件夹,style.css 要在第一层
启用主题后白屏 PHP 语法错误,通常是少分号或括号不配对
页面顶部多出一行空白 ?> 之后有空行,或在文件开头多了 BOM

输出与数据

现象 原因
日期只显示第一篇 用了 the_date(),同一天只输出一次,换 the_time()
报「在 null 上取属性」 $wp_query 忘了 global
相关文章之后内容错位 用了 WP_Query 没调 wp_reset_postdata()
特色图片找不到 没写 add_theme_support( 'post-thumbnails' )
菜单不显示 fallback_cb 没关,或后台没把菜单挂到位置上

样式

现象 原因
改了 CSS 页面没变 浏览器缓存;或 enqueue 的版本号没改
表格双线边框 没写 border-collapse: collapse
手机上整页横向滚动 某个元素宽度超了,常是 pre 缺 overflow-x
子主题样式不生效 父主题样式没挂,或用了 get_stylesheet_directory_uri 取父主题路径

最有用的一条

遇到「改了半天没反应」,先问三句:改的是不是当前生效的那个文件?缓存清了没?报错日志里说什么? 九个问题里有七个出在这三处。

下一篇:全系列复盘。

本系列:迭代式建主题 · 目录(72 篇) | 上一篇 (70) | 下一篇 (72)

相关文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

Powered by 草根站长笔记 © 2015-2026 草根站长笔记 Inc.版权所有,禁止转载