WordPress中出现jQuery(...).signature is not a function错误求助

这个错误本质上是jQuery签名插件没有被正确加载，或是加载顺序、jQuery命名空间的问题导致的。结合WordPress的脚本加载机制，我给你一步步排查和解决的方案：

1. 修正脚本注册与加载的依赖关系 #

WordPress对脚本加载有严格的依赖管理，你必须确保签名插件脚本在jQuery之后加载，并且明确声明依赖。你的代码只处理了样式，脚本部分缺失，完整代码应该是这样：

add_action( 'wp_enqueue_scripts', 'load_custom_wp_style_jsignature' );
function load_custom_wp_style_jsignature() {
    // 加载签名插件样式
    wp_register_style( 
        'ax-link-jsignature', 
        plugins_url( '/path/jsignature/css/jquery.signature.css', __FILE__ )
    );
    wp_enqueue_style( 'ax-link-jsignature' );

    // 加载签名插件核心脚本，依赖jQuery
    wp_register_script( 
        'ax-link-jsignature-script', 
        plugins_url( '/path/jsignature/js/jquery.signature.min.js', __FILE__ ), 
        array( 'jquery' ), // 声明依赖jQuery，WordPress会自动确保先加载jQuery
        false, 
        true // 最后一个参数设为true，让脚本在footer加载，避免DOM未就绪
    );
    wp_enqueue_script( 'ax-link-jsignature-script' );

    // 加载自定义初始化脚本，依赖签名插件脚本
    wp_register_script( 
        'ax-link-signature-init', 
        plugins_url( '/path/js/signature-init.js', __FILE__ ), 
        array( 'ax-link-jsignature-script' ), // 确保签名插件加载后再执行初始化
        false, 
        true 
    );
    wp_enqueue_script( 'ax-link-signature-init' );
}

注意：plugins_url()的第二个参数__FILE__很关键，它能确保路径是相对于你当前插件文件的，避免因为插件目录结构变化导致路径错误。

2. 处理WordPress的jQuery NoConflict模式 #

WordPress默认启用了jQuery的NoConflict模式，这意味着你不能直接使用$作为jQuery的别名，必须改成jQuery，或者用自执行函数包装你的初始化代码。

比如在signature-init.js里写：

// 用document.ready确保DOM加载完成，同时通过参数把jQuery映射为$
jQuery(document).ready(function($) {
    // 这里可以正常使用$了
    $('#your-signature-container').signature({
        // 你的签名插件配置项，比如宽高
        width: 400,
        height: 200
    });
});

如果不想单独写js文件，也可以用wp_add_inline_script直接添加初始化代码：

// 在上面的函数里，wp_enqueue_script('ax-link-jsignature-script')之后添加：
wp_add_inline_script( 'ax-link-jsignature-script', '
    jQuery(document).ready(function($) {
        $("#your-signature-container").signature({ width: 400, height: 200 });
    });
');

3. 排查脚本加载是否成功 #

打开浏览器开发者工具（F12），切换到Network标签，刷新页面后搜索jquery.signature.min.js和jquery.signature.css：

• 如果出现404错误：说明你的路径写错了，检查plugins_url里的路径是否和插件实际文件结构匹配（比如是不是多写了/path/？）
• 如果没找到这两个文件：说明wp_enqueue_style或wp_enqueue_script没有被正确执行，检查钩子wp_enqueue_scripts是否正确，或者你的函数有没有被调用。

4. 排查冲突问题 #

如果以上步骤都没问题，还是报错，可能是其他插件或主题修改了jQuery：

• 检查页面加载的jQuery版本：在控制台输入jQuery.fn.jquery查看版本，确保签名插件支持该版本（keith-wood的签名插件需要jQuery 1.7+）。
• 暂时禁用其他插件，切换到默认主题（比如Twenty Twenty-Four），看错误是否消失，排查是否有冲突。

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