wp_enqueue_script('jquery');
wp_add_inline_script('jquery', "jQuery(function(){ console.log('ready'); });");
在 wp_head 回调里 echo 一段用 $ 的脚本,控制台第一行就是 Uncaught ReferenceError: $ is not defined,后面的交互全部失效。这类现象通常不是突然出现的,往前翻半天日志能看到苗头。
追下去是这么回事:wp_head 在页脚脚本之前执行,jQuery 默认加载在 footer,内联脚本跑的时候还没定义。直接把 script 拼进 head 也绕不过依赖顺序。
这次卡住的地方就在「内联脚本 jQuery 未定义」这一环,单独把它拎出来验证,别和其他改动混在同一次发布里。同类问题如果隔一段时间又出现,多半是某个定时任务或重启流程把改动冲掉了。
把这次用到的命令存进笔记,比记住结论有用,换个环境还能照着走。改完隔一天再看一次,当场正常不代表能稳住。
测试环境和线上的差别,往往就在版本号和那几行被忽略的配置上。
处理上按这个顺序:改用 wp_add_inline_script 挂到 jquery 的 handle 上,由 WordPress 排顺序;脚本确实要在 head 跑,就把 jQuery 的 in_footer 设为 false;用 jQuery 全名替代 $,避免 noConflict 模式下再出问题。
确认没问题再收工,控制台不再报 $ is not defined,内联逻辑在 DOM 就绪后执行。
