在 WordPress 短代码中直接嵌入双引号（"）会导致解析失败；推荐使用单引号包裹整个属性值，使内部双引号作为普通字符保留，从而安全传递含引号的复杂查询字符串。
在 wordpress 短代码中直接嵌入双引号（`"`）会导致解析失败；推荐使用单引号包裹整个属性值，使内部双引号作为普通字符保留，从而安全传递含引号的复杂查询字符串。
WordPress 的短代码解析器（do_shortcode()）默认以双引号或单引号为边界识别属性值。当你写成：
[shortcode filter="taxonomies.pa_color:"red" AND visible:true AND stock>0"]
解析器会在第一个 " 处截断 filter 属性，导致后续内容被忽略或报错——因为双引号未正确配对。
✅ 正确做法：改用单引号包裹整个属性值，此时内部双引号无需转义，原样保留：
[shortcode filter='taxonomies.pa_color:"red" AND visible:true AND stock>0']
该语法完全合法且被 WordPress 原生支持。核心原理是：WordPress 短代码解析器兼容两种属性定界符（" 和 '），只要首尾一致即可。单引号定界时，内部的双引号、空格、冒号、冒号后的内容（如 "red"）均被视为纯文本，不会触发解析中断。
? 补充验证示例（在主题 functions.php 或插件中注册 shortcode）：
function handle_filter_shortcode($atts) {
$atts = shortcode_atts([
'filter' => ''
], $atts);
// 直接输出原始 filter 值，验证是否完整接收
return esc_html($atts['filter']);
}
add_shortcode('shortcode', 'handle_filter_shortcode');调用 [shortcode filter='taxonomies.pa_color:"red" AND visible:true AND stock>0'] 将准确输出：taxonomies.pa_color:"red" AND visible:true AND stock>0
⚠️ 注意事项：
- 不要混用引号（如
filter='..."red"...'中意外插入未闭合双引号）； - 若属性值本身需包含单引号（如
'it's true'），则应改用双引号包裹并转义内部单引号（filter="it\'s true"），但本场景无需此操作； -
"和\"在 shortcode 属性中无效——它们仅在 HTML 输出或 PHP 字符串中起作用，而 shortcode 解析发生在更早阶段，不经过 HTML 实体解码； - 避免依赖 JavaScript 或前端拼接来绕过此限制，违背 shortcode 设计初衷，且存在安全性与可维护性风险。
✅ 总结：面对不可修改的含双引号查询语句（如 Elasticsearch 或自定义 DSL），优先采用单引号定界属性值是最简洁、可靠、符合 WordPress 规范的解决方案。
