本文详解如何为 WordPress 页面（如 product-detail）配置精准的重写规则，将形如 /product-detail/MH-TOOL-152 的友好 URL 映射到实际页面并安全传递 model 参数，避免跳转首页，并支持通过 get_query_var('model') 在模板或短代码中调用。
本文详解如何为 wordpress 页面（如 product-detail）配置精准的重写规则，将形如 `/product-detail/mh-tool-152` 的友好 url 映射到实际页面并安全传递 `model` 参数，避免跳转首页，并支持通过 `get_query_var('model')` 在模板或短代码中调用。
在 WordPress 中实现类似 /product-detail/MH-TOOL-152 这样的语义化 URL 并正确提取参数（如 model=MH-TOOL-152），不能仅依赖 add_rewrite_rule()，还需配合查询变量注册、重写标签声明及正确的查询字符串构造。原始尝试中使用 'index.php/model=$matches[1]' 是无效的——WordPress 不识别该格式，且未声明 model 为合法查询变量，导致重写失败后回退至首页。
✅ 正确实现需三步协同：
-
注册自定义查询变量：确保 WordPress 允许
model作为合法的公共查询参数； -
定义重写规则：将路径映射到目标页面（
pagename=product-detail）并注入model值； -
声明重写标签（可选但推荐）：提升可读性与兼容性，尤其在配合
WP_Rewrite或插件时更健壮。
以下是完整、可直接集成到主题 functions.php 或专用插件中的代码：
// 步骤1：向 WordPress 查询变量白名单添加 'model'
add_filter('query_vars', 'add_model_query_var');
function add_model_query_var($vars) {
$vars[] = 'model';
return $vars;
}
// 步骤2：注册重写规则 —— 将 /product-detail/XXX 映射到 product-detail 页面并传入 model
add_action('init', 'register_product_detail_rewrite_rule');
function register_product_detail_rewrite_rule() {
// 注意：正则需匹配路径段，且目标必须是有效的 WordPress 查询结构
add_rewrite_rule(
'^product-detail/([^/]+)/?$',
'index.php?pagename=product-detail&model=$matches[1]',
'top'
);
}
// 步骤3（推荐）：声明 %model% 重写标签，便于后续扩展（如生成链接）
add_action('init', 'register_model_rewrite_tag');
function register_model_rewrite_tag() {
add_rewrite_tag('%model%', '([^&]+)');
}
⚠️ 关键注意事项：
- ✅
pagename=product-detail要求你的页面 slug 确实为product-detail（后台「页面」→ 编辑页面 → 「永久链接」显示的 slug）；若使用自定义 post type，请替换为post_type=your_cpt&name=xxx。 - ✅ 每次修改重写规则后，必须刷新一次固定链接设置（WordPress 后台 → 设置 → 固定链接 → 点击“保存更改”），否则规则不会生效。
- ❌ 避免使用
index.php/model=...等非法 query string 格式；WordPress 仅接受标准key=value形式（如model=xxx）并经由query_vars注册后才可解析。 - ✅ 在
product-detail页面模板（如page-product-detail.php）或短代码中，通过get_query_var('model')安全获取值：$sku = get_query_var('model', ''); if (!empty($sku)) { echo '<div class="product-sku">SKU: ' . esc_html($sku) . '</div>'; // 此处可加载产品数据、渲染短代码等 }
? 扩展提示：若需支持多参数（如 isToolId），可在规则中增加捕获组，并同步注册对应 query var（如 'isToolId'），例如：
add_rewrite_rule('^product-detail/([^/]+)/([^/]+)/?$',
'index.php?pagename=product-detail&model=$matches[1]&isToolId=$matches[2]', 'top');
再配合 add_filter('query_vars', ...) 添加 'isToolId' 即可。
至此，扫描 QR 码跳转的 https://mywebsite.com/product-detail/MH-TOOL-152 将稳定加载 product-detail 页面，并使 model 可被模板和短代码可靠读取，真正实现语义化路由与业务逻辑解耦。
