wordpress短代码中直接使用echo输出html会导致内容脱离文档流、提前输出，破坏页面结构；正确做法是拼接字符串并统一return，确保内容严格按 shortcode 插入点渲染。
wordpress短代码中直接使用echo输出html会导致内容脱离文档流、提前输出，破坏页面结构；正确做法是拼接字符串并统一return，确保内容严格按 shortcode 插入点渲染。
在 WordPress 开发中，短代码（shortcode）函数必须返回字符串，而不能直接输出（echo/print）——这是导致表单“跳到页面左上角”的根本原因。当你的 show_form() 函数调用 echo 时，PHP 会立即将 HTML 写入响应缓冲区，往往发生在 WordPress 主题的
尚未完全加载之前，造成浏览器将其渲染在可视区域顶部（即左上角），完全脱离你期望的 shortcode 所在段落位置。✅ 正确实现方式：
- 使用变量（如 $output）逐步拼接所有 HTML 和逻辑结果；
- 表单提交后的成功提示也应作为字符串返回，而非 echo 或 return 中途退出；
- 始终以 return $output; 结束函数，确保内容被 WordPress 解析器精准注入到 shortcode 标签所在位置。
以下是优化后的完整短代码函数（含安全增强）：
Chinese Sensitive Words
下载
中文敏感词/违禁词检测与内容合规性检查工具。支持对小红书（Xiaohongshu）、Douyin（抖音）、WeChat（微信）、Weibo（微博）、Bilibili（哔哩哔哩）、Zhihu（知乎）、Taobao（淘宝）、JD.com（京东）等主流平台的禁用词、限用词及高风险词进行文本扫描与合规性分析。
function show_form() {
$user_id = get_current_user_id();
$output = '';
// 构建表单（未提交时显示）
$output .= '
';
// 处理表单提交
if (isset($_GET['send_btn']) && isset($_GET['inches'])) {
$bicep = floatval(sanitize_text_field($_GET['inches'])); // 安全过滤与类型校验
if ($user_id === 0) {
$output .= '⚠️ Please log in to save your measurement.
'; return $output; } // 更新用户元数据 update_user_meta($user_id, '_bicep_measurement', $bicep); $output .= '✅ Today your bicep is: ' . esc_html($bicep) . ' inches!
'; } return $output; } add_shortcode('show_form', 'show_form');? 关键注意事项：
- 禁止在 shortcode 函数中使用 echo、print、var_dump 或任何直接输出函数；
- 始终对用户输入（如 $_GET['inches']）执行 sanitize_text_field() 或更严格的校验（如 floatval() + 范围检查）；
- 使用 esc_html() 输出动态内容，防止 XSS；
- 为表单添加 class 便于 CSS 定位与样式控制，避免默认布局错乱；
- 若需支持 AJAX 提交（推荐用于生产环境），应禁用 GET 方法，改用 admin-ajax.php + nonce 验证，提升安全性与用户体验。
通过遵循“纯返回、零输出”原则，你的表单将严格内联渲染在文章/页面中 shortcode 所在位置，彻底解决偏移问题，并为后续功能扩展打下健壮基础。
