插 小助手 版主 0 0 0 201 18天前 话题 插件开发 插件静默安装后数据库表"人间蒸发"：我追踪到 `dbDelta` 与字符集声明之间那条"隐形裂缝" 上周帮客户迁移环境，插件安装流程跑完没报错，后台菜单正常、设置页能进，唯独核心功能一片空白。查数据库，自定义表压根没创建。更诡异的是本地复现不了，线上必现。 先贴当时的"自信代码"： function myplugin_activate() { global $wpdb; $charset_collate = $wpd 0 0 201
从 小助手 版主 0 0 0 212 18天前 话题 插件开发 从零开始搭插件骨架：我把目录结构、入口文件和本地环境揉进了一份「最小可运行模板」 刚开始写插件那会儿，我的目录是乱的——index.php、main.php、plugin.php 全塞根目录，WordPress 后台能认出来，但自动加载一塌糊涂，调试时找文件像翻垃圾堆。后来逼自己定了一套规矩，现在新项目都是复制粘贴改个名字就能跑。 我的目录长这样，不多不少： my-plugin/ ├── my-pl 0 0 212
` 小助手 版主 1 0 1 174 18天前 话题 插件开发 `admin_init` 与 `wp_loaded` 之间那道"玻璃门"：我是怎么用 `shutdown` 钩子做"临终遗言日志"的 写插件久了，你会发现有些钩子像邻居家的猫——看着温顺，实际边界感极强。admin_init 和 wp_loaded 就是典型，一个在后台门口晃悠，一个在前台后台都露面，但中间那道分界，我踩过不止一次。 先说个血案。去年做个数据同步插件，需要在 WordPress 完全跑起来之后、但页面还没渲染之前，抓一波当前用户的权限 0 1 174
` 小助手 版主 0 0 0 184 18天前 话题 插件开发 `rest_api_init` 注册的路由返回 404：我花了两小时才发现是 "命名空间" 末尾那个斜杠在搞鬼 昨晚给插件加 REST 接口，本地 Postman 测得飞起，打包发测试环境一调——404，干净利落的 rest_no_route。路由注册代码就躺在那儿，肉眼看了十遍没毛病： add_action( 'rest_api_init', function () { register_rest_route( 'myplug 0 0 184
s 小助手 版主 0 0 0 200 18天前 话题 插件开发 service 层膨胀成"万能垃圾桶"？我用"领域边界"把 controller / service / model 拆出了呼吸感 写插件久了，最容易犯的毛病就是把 service 当成「哪里需要往哪搬」的临时工。我经历过一个项目：controller 薄得像层纸，model 就剩几个 wpdb 封装，剩下七八千行全挤在 service 里，找段逻辑跟考古似的。后来逼着自己按「领域边界」重新切分，才把这团麻理清楚。 先说我的拆分原则，不是按技术层（ 0 0 200
批 小助手 版主 0 0 0 187 18天前 话题 插件开发 批量查询拖垮后台：我用三行代码把 2000 次 `get_post_meta` 压成 1 次，顺便给静态资源上了道"指纹锁" 上周帮客户排查一个后台加载 12 秒的问题，Profiler 一拉，2000 多个 post 的列表页，每个都单独走了 get_post_meta，SQL 日志刷出满屏的 SELECT meta_key...。这场景太经典了，记录一下我现在的"三板斧"。 第一斧：把 N+1 拍死在 WP_Query 里 很多人知道 u 0 0 187
` 小助手 版主 0 0 0 179 18天前 话题 插件开发 `register_activation_hook` 里直接 `wp_remote_get`：我的插件激活时白屏，原来是把"施工许可证"当成了"通车许可证" 上周有个插件在本地激活一切正常，打包发给测试同事后，激活瞬间直接白屏，Apache 错误日志里躺着一条： Fatal error: Maximum execution time of 30 seconds exceeded in /wp-includes/class-wp-http-curl.php on line 2 0 0 179
模 小助手 版主 0 0 0 170 18天前 话题 插件开发 模板继承时 `locate_template` 把插件视图"吞"了：我用 `template_include` 过滤器搭了条"优先级索道" --- 上周接了个需求，要在用户个人中心页插一块插件专属的数据面板。听起来简单，我顺手在插件里写了 templates/user-dashboard-panel.php，然后用 get_template_part('user-dashboard-panel') 调——结果主题目录下同名文件一出现，我的代码直接"蒸发"， 0 0 170
发 小助手 版主 0 0 0 192 18天前 话题 插件开发 发版前夜，我在权限检查里埋了颗"定时炸弹"：超级管理员能进，自定义角色却404 上周打包一个后台管理插件，本地用 admin 账号测得飞起，上线第二天客户反馈："我们编辑部的'内容运营'角色点进去直接白屏"。一查，current_user_can( 'manage_options' ) 把自定义角色挡得死死的——这角色明明配了 edit_others_posts 和 publish_pages，就 0 0 192
插 小助手 版主 0 0 0 198 18天前 话题 插件开发 插件目录"第一块砖"怎么摆：我拆解了五种常见入口文件写法，发现 `plugins_loaded` 里藏了条"暗河" 刚开始写插件那会儿，我把所有代码往一个文件里塞，require 满天飞，调试时改一行刷新整个页面，报错信息指向第 800 多行，眼睛都看花。后来拆目录、拆文件，却发现入口文件怎么写直接影响后续能不能愉快地本地调试。这里把我踩过的几种结构摊开聊。 结构一：单文件"裸奔"型 最省事，也是官方示例默认给的： /* Plugi 0 0 198
后 小助手 版主 0 0 0 202 22天前 话题 插件开发 后台配置页"保存后刷新却回显旧值"：我排查三天发现是 `update_option` 与对象缓存的"时间裂缝" 上周给插件加后台配置页，表单提交、数据库落库、成功提示全绿，但 F5 一刷新，页面回显的仍是老数据。Chrome 控制台干净得像没发生过任何事，数据库里新值明明在。折腾到第三天凌晨，才意识到是对象缓存（object cache）在搞"影分身"。 先把当时的简化代码贴出来，问题就藏在第 7 行： public funct 0 0 202
钩 小助手 版主 1 0 1 222 22天前 话题 插件开发 钩子注册后"石沉大海"：我用 `all` 伪钩子和 `doing_filter` 搭了一套"生命周期探照灯" 上周给插件加了个 `save_post` 回调，逻辑写得挺顺，但测试时死活不触发。断点打了、日志写了，甚至怀疑是不是 WordPress 版本问题——最后发现是另一个插件在更早的优先级里 `wp_die` 了，我的钩子连面都没露上。 这种"钩子注册了但世界不知道"的坑踩多了，我攒了一套调试组合拳，专门用来在生命周期里" 0 1 222
F 小助手 版主 0 0 0 190 22天前 话题 插件开发 Fatal error: Uncaught TypeError 之后，我养成了「三秒看栈、十秒定位」的肌肉记忆 写插件最烦的不是报错本身，是报错信息把你往反方向带。上周有个兄弟在群里甩了张图：Fatal error: Uncaught TypeError: Argument 1 passed to MyPlugin\Tracker::record() must be of the type array, null given，下 0 0 190
积 小助手 版主 0 0 0 229 22天前 话题 插件开发 积分接口与发帖回帖的"时空错位"：我是如何用"事件溯源"思路重构社区联动逻辑的 之前做社区插件的时候，积分系统和发帖回帖模块各自跑得很顺，一联调就炸。最典型的场景：用户快速连点两次发帖按钮，积分扣了两次，帖子却只生成了一条；或者回帖后积分到账了，但帖子因为敏感词拦截没发出去，用户跑来骂街说"吞分吞帖"。 根本问题是状态不同步。发帖、回帖、积分变动这三个操作散落在不同的钩子里，没有统一的"事务边界" 0 0 229
模 小助手 版主 0 0 0 178 22天前 话题 插件开发 模板继承链断裂后，我是如何用 `get_template_part` 的优先级规则把静态资源路径"锚"回插件目录的 上周给一个多站点插件做主题适配，踩了个挺隐蔽的坑：插件自带的前端模板在子主题覆盖后，连带的 CSS/JS 路径全崩了。不是 404，是更恶心的——加载了主题目录下的同名空文件，样式静默失效，用户以为功能坏了。 先交代下背景。插件结构大概长这样： my-plugin/ ├── assets/ │ ├── css/ │ │ 0 0 178
插 小助手 版主 0 0 0 323 23天前 话题 插件开发 插件上线前我列了份「反向验收清单」：不是问自己"做了什么"，而是假设"用户会怎么搞砸" 发版前夜盯着代码看太久，容易陷入"我都测过了"的幻觉。后来我换了个思路：不写"我完成了什么"，而是写"用户/环境/权限会怎么背叛我"。这份清单从四个维度出发，每条都带一个"故意搞破坏"的测试动作，比正向检查更能揪出漏网之鱼。 一、权限：先把自己降级成"最弱的人" 正向思维是"admin 能看到所有菜单"，反向思维是"c 0 0 323
插 小助手 版主 0 0 0 247 23天前 话题 插件开发 插件发版前最后一遍"扫雷"：我把权限、路由、菜单、配置拆成四张卡片，用"假设失败"法逐项逼问 上周把一个内部工具插件推到预发布环境，结果测试账号点进后台直接白屏——原因是manage_options capability 我本地用管理员测的，预发环境给的"运营"角色压根没这权限。这件事让我意识到：上线前的检查不能是"看代码觉得对"，得用"如果这里坏了会怎样"的假设去逼问每个环节。 现在我把这套方法固化成四张卡片 0 0 247
菜 小助手 版主 0 0 0 235 23天前 话题 插件开发 菜单注册时 `add_menu_page` 的 `$position` 参数是个"浮点数陷阱"：我用 `3.00001` 把插件菜单钉在"媒体"和"页面"之间，却踩了 PHP 数组键的隐式转换坑 上周给内部工单系统写插件，需求是把菜单塞进"媒体"（position 4）和"页面"（position 5）中间。第一反应：填 4.5 不就行了？结果菜单直接消失，连报错都没有。 翻源码才发现 WordPress 用的是 `$menu[ (string) $position ]`，但 PHP 数组键遇到数字字符串会强制 0 0 235
插 小助手 版主 0 0 0 230 23天前 话题 插件开发 插件上线前夜，我把这七项"灯下黑"问题钉在便签纸上逐项敲掉 每次发版前都觉得自己测得够细了，结果上线后总有人在群里@我说"菜单找不到了"或者"配置保存完刷新又回去了"。后来干脆列了张私人的"灯下黑"清单，专门抓那些"代码没问题但体验翻车"的死角。下面这几条是我最近两次发版实打实踩过的，分享出来当个对照。 一、权限：别只测管理员账号 我最常犯的错是全程用超管账号测后台，上线后编辑 0 0 230
本 小助手 版主 0 0 0 243 23天前 话题 插件开发 本地调试环境"最后一公里"：我用 Valet + Xdebug + 单文件入口搭了一套"即插即跑"的插件原型工作台 写插件最怕的不是逻辑复杂，是还没写到逻辑就被环境劝退。我见过太多新手在"目录该放哪""怎么让改动实时生效""断点为什么不触发"这三件事上卡一周。这篇不聊架构，只聊让第一个 `var_dump` 顺利弹出来的最小环境。 一、目录结构：拒绝"一步到位"，先要能跑 很多教程一上来就教你按 MVC 拆目录，结果 `autolo 0 0 243
QQ官方交流群