WooCommerce Checkout 模板不生效？模板优先级被插件覆盖
给 Checkout 页面分配主题的 checkout 模板后，前台渲染出来的还是 WooCommerce 自带的那套结构——主题模板的 heading 和 footer 都不在，body class 却显示模板分配已生效。
在为客户开发极简 FSE WordPress 主题时遇到此问题——面向企业站和轻量电商场景的 WordPress 全站编辑主题，WooCommerce 兼容走轻量原则。
TL;DR
WooCommerce 在 page_template_hierarchy filter 上以优先级 1 把自己的模板 slug（checkout、cart）插到模板层次数组最前面，插件模板因此排在几乎所有候选之前。此时再手动给页面设置 _wp_page_template 只会制造第二套互相矛盾的信号——body class 读 meta、渲染走 filter。解法：删掉手动设置的 _wp_page_template，交给 hierarchy filter 自动解析。
问题现象：body class 显示主题模板，渲染内容却是插件的
页面编辑器里模板分配明明写的是主题 checkout 模板，body class 也如实显示 page-template-checkout；但前台渲染出来的内容是 WooCommerce 的 page-content-wrapper——只有 store notices 和产品内容，主题模板里的 heading、footer 结构一个都不在。
排查的判断标记只有一处：检查页面 <main> 元素上有没有 data-block-name="woocommerce/page-content-wrapper" 属性。有，就是 WooCommerce 的插件模板在实际渲染；主题模板被架空的判断到此坐实。
「body class 说 A、渲染是 B」这类自相矛盾的症状，几乎总意味着系统里存在两套互不同步的信号源——这台机器里恰好就有一对。
根因：page_template_hierarchy 以优先级 1 插队
WooCommerce 的 AbstractPageTemplate 在 init() 里注册了这个 filter：
add_filter( 'page_template_hierarchy', array( $this, 'page_template_hierarchy' ), 1 );
回调内容是一行 array_unshift：当页面命中 Checkout/Cart 场景时，把自己的模板 slug 插到候选数组最前面。源码注释写得很清楚——优先级 1 是刻意的，为保证最先执行；其他扩展若用默认优先级 10，就只能排在它后面。
WordPress 解析模板时按数组顺序找第一个存在的模板文件。Checkout 这个 slug 被插到队首后：主题里有同名模板文件就用主题的；没有，就落到 WooCommerce 注册的同名插件模板（page-checkout.html，内含 woocommerce/page-content-wrapper 结构）。
手动设置 _wp_page_template 为什么帮倒忙？这个 meta 只影响 body class 和后台显示，插不进 filter 的解析顺序——它生成的信号与 filter 的解析结果各走各的，于是出现「分配显示已生效、渲染纹丝不动」的僵局。
解决方案：删掉 _wp_page_template，交给 hierarchy filter
删掉手动设置的模板 meta，让 WooCommerce 的解析机制自己走：
wp post meta delete <page_id> _wp_page_template
删除后 body class 与渲染恢复一致：filter 解析到什么就渲染什么、body class 也如实反映。不需要再显式设置任何模板 meta——WooCommerce 接管的页面上，hierarchy filter 就是权威信号源。
Cart 模板的另一处结构坑（占位符与 SSR 渲染）与本篇同属模板层，排查 Checkout 时值得一起核对。
注意事项
删除 meta 后不要「验证是否生效」时又手动补回 _wp_page_template——这正是制造矛盾信号的来源。Cart 页面同样走这套机制，若它也出现过分配不生效，用同一方式处理；诊断标记统一认 data-block-name="woocommerce/page-content-wrapper"。
常见问题
WooCommerce 是怎么抢到模板解析权的？
它在 page_template_hierarchy filter 上挂了优先级 1 的回调，比默认优先级 10 的其他消费者都早执行，把自己的模板 slug 插到层次数组最前面。WooCommerce 源码注释明确说明这个优先级是刻意为之。
body class 与实际渲染为什么不一致？
两套信号源：body class 直接读 _wp_page_template meta 生成，实际用哪个模板由 hierarchy filter 的数组顺序决定。meta 手动设置后，信号就与 filter 的解析结果脱节了。
怎么确认当前渲染的是插件模板？
只有一个可靠标记：main 元素上的 data-block-name 属性。出现 data-block-name="woocommerce/page-content-wrapper" 即插件模板在渲染；主题模板渲染的 main 由主题自己的区块构成，不带这个标记。
Cart 页也会被同样接管吗？
会。同一套 AbstractPageTemplate 机制下有 CartTemplate 和 CheckoutTemplate 两个实现，Cart、Checkout 两类页面都在接管范围内，排查都用同一个 data-block-name 标记。