WordPress禁用Google Maps API的规范方案及代码问题排查

一、规范方案 #

• 子主题中使用wp_dequeue_script或wp_deregister_script是WordPress官方推荐的规范方案：
  • 注释父主题代码或直接移除文件的方式，会在主题更新时丢失所有修改，完全不可取；
  • 子主题是WordPress原生设计用于自定义修改的渠道，所有自定义逻辑都应放在子主题中，避免依赖父主题的代码结构。

二、代码无效的原因及修正方法 #

你的代码未生效，核心问题是错误地使用了脚本的文件名/URL作为wp_dequeue_script的参数——WordPress中脚本的唯一标识是注册时定义的handle（句柄），而非文件名或请求URL。

1. 如何找到正确的脚本Handle #

• 打开浏览器开发者工具查看页面源码：WordPress会为每个加载的脚本添加data-handle属性，属性值就是该脚本的handle；
• 或在子主题functions.php中临时添加以下代码，打印所有已注册的脚本handle：

  add_action( 'wp_print_scripts', function() {
      global $wp_scripts;
      foreach( $wp_scripts->registered as $handle => $script ) {
          echo $handle . '<br>';
      }
  } );
  

  访问页面后，就能看到所有脚本的handle列表，从中找到Google Maps相关的标识（比如Jobify主题通常会用jobify-google-maps、google-maps-api这类自定义handle，Google Maps官方主脚本的handle一般是google-maps）。

2. 修正后的示例代码 #

找到正确的handle后，使用更高优先级的钩子（比如999，确保晚于主题/插件注册脚本的时机）来取消加载：

function dequeue_google_maps_scripts() {
    // 替换为你找到的实际handle
    wp_dequeue_script( 'jobify-google-maps' );
    wp_deregister_script( 'jobify-google-maps' );
    
    // 若存在common.js/util.js对应的子脚本handle，同样替换后处理
    wp_dequeue_script( 'google-maps-common' );
    wp_deregister_script( 'google-maps-common' );
}
add_action( 'wp_enqueue_scripts', 'dequeue_google_maps_scripts', 999 );

3. 补充说明 #

• wp_dequeue_script仅取消当前页面的脚本加载，不影响脚本本身的注册；wp_deregister_script会彻底注销脚本，确保任何场景都无法再加载它，可根据需求选择；
• 若WP Job Manager插件也加载了Google Maps，需用同样方法排查插件注册的脚本handle并一并处理。

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