wp_localize_script返回false原因排查：插件成功入队script.js但对象无法访问

我来帮你排查这个wp_localize_script的问题——这种情况我碰到过好几次，大概率是入队顺序或者参数细节出了问题，咱们一步步拆解：

最常见的问题：脚本入队和本地化的顺序搞反了 #

WordPress要求必须先调用wp_enqueue_script注册/入队脚本，再调用wp_localize_script，而且两者的handle（第一个参数）必须完全一致。举个正确的示例：

// 第一步：先入队你的脚本
wp_enqueue_script(
    'my-custom-script', // 这个handle要和下面localize的第一个参数完全匹配
    get_template_directory_uri() . '/js/script.js',
    array('jquery'), // 依赖项（如果有的话）
    '1.0.0',
    true // 放在footer加载，可选
);

// 第二步：再执行本地化
$localized_data = array(
    'ajax_url' => admin_url('admin-ajax.php'),
    'site_name' => get_bloginfo('name')
);
// 这里的第一个handle必须和上面的完全一样！
$localize_result = wp_localize_script('my-custom-script', 'MySiteData', $localized_data);

// 临时调试：看看返回值
// var_dump($localize_result);

如果反过来先调用wp_localize_script再入队脚本，WordPress找不到对应的脚本handle，直接返回false，自然也不会输出变量。

第二大概率：Handle拼写错误 #

检查wp_enqueue_script和wp_localize_script的第一个参数（handle），必须大小写、符号、空格完全一致。比如my-script和MyScript、my_script都是不同的handle，差一点都不行。

其他可能的排查点 #

1. 脚本是否真的被入队
   可以用wp_script_is('your-handle', 'enqueued')来验证脚本是否成功入队，如果返回false，先解决脚本入队的问题：比如路径是否正确、依赖的脚本（比如jQuery）是否加载、钩子是否用对（应该挂在wp_enqueue_scripts钩子上）。

2. 变量名冲突或执行时机问题

   • 如果页面源代码里能找到你的object_name变量，但script.js里访问不到，可能是脚本代码在变量输出前就执行了。把你的JS代码放在DOMContentLoaded或者jQuery的就绪函数里：

     document.addEventListener('DOMContentLoaded', function() {
         console.log(MySiteData); // 现在应该能正常访问了
     });
     

   • 另外，避免用data、app这种太通用的变量名，容易和其他插件/主题的变量冲突，改成更独特的名字比如MyThemeCustomData。

3. 钩子优先级问题
   确保你的入队和本地化代码挂在wp_enqueue_scripts钩子上，优先级别太低（默认10就可以），如果优先级设得太高，可能在脚本注册前就执行了本地化。

先从顺序和handle拼写这两点查起，这几乎是90%的此类问题的根源。

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