WordPress自定义JS脚本无法加载问题求助

看起来你在给自定义WordPress主题添加JS脚本时遇到了加载失败的问题，我先从你提供的代码里找几个明显的问题，再一步步帮你排查：

1. 先修复代码里的截断和大小写问题 #

你贴的代码最后一行wp_enqueue_script('CustomCo...是截断的，而且还有一个容易踩坑的细节：WordPress的脚本ID是区分大小写的！你注册第一个脚本用的ID是html2Canvas（大写C），但第二个脚本的依赖写的是html2canvas（小写c），这会直接导致依赖关系失效。

先把代码补全并修正：

add_action( 'wp_enqueue_scripts', 'add_my_script' );
function add_my_script() {
    // 注册html2canvas，依赖jQuery，设置为页脚加载
    wp_register_script('html2Canvas', get_template_directory_uri() .'/js/html2canvas.js', array('jquery'), '1.4.1', true);
    // 注册自定义控制器，依赖jQuery和html2Canvas（注意ID大小写和注册时一致）
    wp_register_script('CustomController', get_template_directory_uri() . '/js/CustomController.js', array('jquery','html2Canvas'), '1.0.0', true);
    
    // 入队两个脚本
    wp_enqueue_script('html2Canvas');
    wp_enqueue_script('CustomController');
}

我这里给脚本加了具体版本号，方便后续更新时刷新浏览器缓存，你可以根据实际情况修改版本号。

2. 检查文件路径是否正确 #

• 确认你的主题根目录下确实存在js文件夹，并且里面有html2canvas.js和CustomController.js这两个文件
• 打开浏览器开发者工具（F12），切换到「网络」标签，筛选「JS」类型，查看脚本请求状态：
  • 如果是404状态，说明路径写错了，比如是不是把js写成了JS？或者文件放在子文件夹里没补充路径？
  • 如果你用的是子主题，记得把get_template_directory_uri()换成get_stylesheet_directory_uri()——前者指向父主题路径，后者才是子主题的正确路径。

3. 验证脚本是否成功入队 #

可以在函数里加一行调试代码，确认脚本有没有被正确入队：

add_action( 'wp_enqueue_scripts', 'add_my_script' );
function add_my_script() {
    // 上面的注册和入队代码...
    
    // 调试：检查脚本是否入队成功
    var_dump(wp_script_is('html2Canvas', 'enqueued'));
    var_dump(wp_script_is('CustomController', 'enqueued'));
}

访问页面后，顶部会输出bool(true)说明入队成功，如果是bool(false)，那可能是其他代码（比如插件、主题的其他功能）把脚本取消入队了。

4. 查看前端错误提示 #

打开浏览器的「控制台」标签，查看报错信息：

• 如果提示html2canvas is not defined，说明要么html2canvas没加载，要么依赖关系没生效导致CustomController先加载了
• 如果是文件加载错误，根据提示调整路径即可

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