如何为WordPress网站添加JS？wp_enqueue_script失效求助

现存代码的直接错误 #

你当前functions.php的逻辑存在两处会直接导致脚本不加载的问题：

• 第一行代码挂载了form_enqueue_style回调函数，但整个文件里根本没有定义这个函数，PHP触发静默错误时会直接中断后续所有逻辑执行，你写的脚本挂载代码根本不会被运行
• 没有考虑文件缓存、路径校验的基础排查逻辑，哪怕代码跑通，也可能因为缓存、路径错误看不到加载效果

可直接替换的正确代码 #

把原来错位的钩子和函数逻辑，替换成如下统一管理的版本，和你原主题自带的代码完全兼容：

<?php
// 保留主题原有头部注释和核心初始化代码不动，在文件末尾追加如下逻辑
add_action( 'wp_enqueue_scripts', 'load_custom_form_assets' );
function load_custom_form_assets() {
    wp_enqueue_script(
        'form-js',
        get_template_directory_uri() . '/js/form.js',
        array(), // 如果你的JS依赖jQuery，把这里改成array('jquery')
        filemtime( get_template_directory() . '/js/form.js' ), // 自动读取文件修改时间做版本标识，彻底避免缓存卡旧文件
        true // 设置为true，脚本会输出到页脚wp_footer()位置
    );
}

补全后续排查的关键检查项 #

改完代码后如果还是看不到脚本输出，按顺序核对以下点：

• 直接在浏览器输入JS文件的完整访问地址，确认没有404：比如访问你的域名/wp-content/themes/Income_School/js/form.js，能看到完整JS代码才说明路径、文件名、目录位置完全正确（注意检查大小写匹配，很多主机对文件大小写敏感）
• 打开主题的footer.php文件，确认在</body>标签闭合前存在wp_footer();函数调用——没有这个钩子的话，所有设置为页脚加载的脚本都不会被输出到页面上
• 清除网站全站缓存、浏览器本地缓存，强制刷新页面后查看页脚的源码输出，确认有没有你注册的script标签
• 临时停用Scripts n Styles插件，检查是不是这类前端注入类插件的过滤规则，把你的自定义脚本拦截掉了

内容的提问来源于stack exchange，提问作者Steel8