WordPress 子主题完整指南二：子主题如何正确的修改父主题中的JS文件
在 WordPress 里，子主题的机制主要是针对 PHP 模板文件（如 single.php、header.php）和样式文件（CSS） 的覆盖。但是 静态 JS 文件（或者 CSS 文件）是不会像 PHP 模板那样自动覆盖的。
为什么子主题的 JS 不会自动覆盖
WordPress 的 JS、CSS 一般是通过 functions.php 里的 wp_enqueue_script() / wp_enqueue_style() 来注册和加载的。
当父主题先 enqueue 了一个 script.js，子主题如果放一个同名的 script.js，并不会自动替换掉父主题的版本。
浏览器加载时只认你在 wp_enqueue_script() 里声明的那个路径，文件名相同也不会被覆盖。
正确的操作
如果你想在子主题中替换或覆盖父主题的 JS，需要在子主题的 functions.php 里操作。
方法有两种：
方法一：在子主题里加载新的 JS 覆盖功能
这种方式最简单，你只需要在子主题里单独加载一个 extra.js 文件，里面写你想要的逻辑。父主题的 JS 不会受影响。
如果你只是想加一些自己的逻辑，不想完全替换父主题的 JS，可以直接在子主题 functions.php 里再 enqueue 一个脚本：
// 定义一个函数，用来给 WordPress 页面添加额外的脚本
function mytheme_add_scripts() {
// 使用 wp_enqueue_script() 函数注册并加载一个 JS 文件
wp_enqueue_script(
'child-extra', // 脚本的句柄（唯一名称），后续可以用这个名字移除或依赖
get_stylesheet_directory_uri() . '/js/extra.js', // 脚本文件路径，这里指向子主题目录下的 js/extra.js
array('jquery'), // 脚本依赖项，这里表示该脚本依赖 jQuery，确保 jQuery 先加载
'1.0.0', // 脚本的版本号，用于缓存控制。改版本号后浏览器会重新加载新文件
true // 是否将脚本放在页面底部（true 表示在 </body> 前加载，false 表示在 <head> 加载）
);
}
// 将上面定义的函数挂载到 wp_enqueue_scripts 钩子上
// wp_enqueue_scripts 是 WordPress 专门用于前端脚本和样式加载的钩子
add_action('wp_enqueue_scripts', 'mytheme_add_scripts');这样父主题的 JS 会照常运行，你的 extra.js 会在它之后加载，用来扩展或覆盖一些功能。
方法二：在子主题 JS 里“钩子化”扩展父主题逻辑
很多主题的 JS 会在全局对象里定义函数或事件，你可以在 extra.js 里：
- 监听 DOM 事件（如
document.ready，click等）， - 覆写特定函数，
- 扩展现有逻辑。
例如：
// 子主题 extra.js
jQuery(document).ready(function($) {
console.log('子主题逻辑已加载');
// 给父主题按钮加一个额外的点击逻辑
$('#some-button').on('click', function() {
alert('这是子主题新增的逻辑');
});
});方法三：取消父主题的 JS，再注册自己的版本
需要注意的是，这种方法会完全覆盖父主题中的JS文件
// 先移除父主题注册的脚本，再注册子主题自己的脚本
function mytheme_replace_parent_js() {
// 假设父主题注册脚本的句柄叫 'parent-extra' （名字要和父主题 enqueue_script 里的第一个参数一致）
wp_dequeue_script('parent-extra'); // 移除队列里的父主题脚本
wp_deregister_script('parent-extra'); // 完全注销这个脚本（可选，但推荐）
// 注册并加载子主题的替代脚本
wp_enqueue_script(
'parent-extra', // 这里用和父主题一样的句柄，保证依赖关系不会出错
get_stylesheet_directory_uri() . '/js/extra.js', // 子主题里的替换文件
array('jquery'), // 依赖
'1.0.0', // 版本号
true // 放在 footer
);
}
add_action('wp_enqueue_scripts', 'mytheme_replace_parent_js', 20); // 注意优先级调高，保证在父主题之后执行⚠️ 重点是要知道父主题用的句柄（handle），你得去父主题
functions.php或inc/enqueue.php里看。
总结
子主题不会像 PHP 模板一样自动覆盖父主题的 JS。
必须通过 wp_dequeue_script + wp_enqueue_script 的方式来替换，或者额外 enqueue 脚本来覆盖逻辑。
如果你只是想“加逻辑”，用 方法一 + extra.js 就够了；
如果你需要在已有逻辑基础上增强功能，用 方法二 在 extra.js 里扩展或覆盖父主题的行为；
只有在必须完全替换父主题 JS 的时候，才需要用到方法三 wp_dequeue_script / wp_deregister_script。