Zsens Admin 插件静态资源"路径漂移"：我的 CSS 在子主题下 404，根源竟是 `plugin_dir_url` 与 `get_stylesheet_directory_uri` 的"宿主幻觉"

上周帮一个用我插件的站长排查问题，他的子主题一启用，插件后台的样式全崩了。F12 一看，zsens-admin/assets/css/dashboard.css 返回 404，路径变成了 https://example.com/wp-content/themes/child-theme/zsens-admin/assets/css/dashboard.css——我的资源被"吸"进子主题目录了。

事情要从我偷懒的加载方式说起。早期为了"让模板能覆盖"，我把资源文件和 PHP 模板放得太近，用了这种混合写法：

// 错误示范：模板继承的副作用污染了资源路径
public function enqueue_assets() {
    $template_path = get_stylesheet_directory() . '/zsens-admin/';
    // 想的是"优先找子主题覆盖"，结果连 CSS 也走这条路
    $css_file = locate_template( 'zsens-admin/assets/css/dashboard.css', false );
    
    if ( $css_file ) {
        // 子主题存在"同名路径"时，plugin_dir_url 被覆盖
        $css_url = get_stylesheet_directory_uri() . '/zsens-admin/assets/css/dashboard.css';
    } else {
        $css_url = plugin_dir_url( __FILE__ ) . '../assets/css/dashboard.css';
    }
    
    wp_enqueue_style( 'zsens-dashboard', $css_url );
}

问题出在 locate_template 的语义陷阱。这个函数天生为 PHP 模板服务，它会递归搜索子主题→父主题→插件（需 filter），但返回的路径是文件系统绝对路径。我强行把它转成 URL 时，假设了"文件存在 = 同一目录结构"，却忽略了子主题作者完全可以只丢一个 dashboard.php 进来，我的代码却以为 assets/css/ 也跟着存在了。

更隐蔽的是：子主题作者为了"微调样式"，复制了我的 templates/dashboard.php，连带创建了 zsens-admin/ 目录。WordPress 的文件系统遍历让 locate_template 命中了这个目录，但里面根本没有 assets/ 子树——路径存在，文件不存在，404 得悄无声息。

现在的方案把"模板继承"和"资源发布"彻底拆成两条管线：

/**
 * 资源路径：只认插件本体，不允许主题覆盖
 * 主题想改样式？用 wp_enqueue_style 的依赖覆盖或额外添加
 */
public function get_asset_url( $relative_path ) {
    // 强制锚定在插件目录，绕过所有主题解析
    return plugins_url( $relative_path, dirname( __DIR__ ) . '/zsens-admin.php' );
}

/**
 * 模板路径：允许子主题 > 父主题 > 插件回退
 */
public function get_template_path( $template_name ) {
    $theme_template = locate_template( 'zsens-admin/' . $template_name );
    
    if ( $theme_template ) {
        return $theme_template; // 文件系统路径，供 include 用
    }
    
    return plugin_dir_path( __DIR__ ) . 'templates/' . $template_name;
}

关键区分：plugins_url() 和 plugin_dir_url() 都基于插件文件位置，不受主题切换影响；而 locate_template、get_stylesheet_directory* 系列是主题域的，两者绝不在同一条赋值链里混用。

add_action( 'wp_enqueue_scripts', function() {
    global $wp_styles;
    if ( isset( $wp_styles->registered['zsens-dashboard'] ) ) {
        error_log( 'ZSENS CSS SRC: ' . $wp_styles->registered['zsens-dashboard']->src );
        // 对比 $_SERVER['REQUEST_URI'] 看是否 404
    }
}, 999 );