在 wordpress 主题的 `header.php` 中调用自定义 php 函数（如输出 meta 描述）时，若直接使用 `` 会导致内容为空，根本原因是该函数未返回值——必须使用 `echo` 显式输出其返回结果。

WordPress 主题中，functions.php 文件常用于定义工具函数，例如生成动态页面描述：

// functions.php 中的示例函数（务必有 return）
function meta_desc() {
    if (is_home() || is_front_page()) {
        return '欢迎访问我们的 WordPress 博客，分享前端开发与主题定制技巧。';
    } elseif (is_single()) {
        global $post;
        return wp_trim_words($post->post_excerpt ?: $post->post_content, 20, '…');
    } else {
        return get_bloginfo('description');
    }
}

⚠️ 关键注意点：

• 函数必须使用 return 返回字符串，而非 echo 或 print 输出；
• 在 header.php 的 HTML 属性中（如 content=""），需用 显式输出，因为 仅执行但不回显；
• 若函数内部已含 echo，则不可再套用 echo，否则会报错或重复输出——推荐统一采用 return + 外部 echo 的模式，更安全、可控。

正确写法（header.php 中）：

前端设计引擎

使用此技能可创建独具特色、具备生产级质量的前端界面，设计品质高。当用户要求构建网页组件、页面、产物、海报或应用程序时（例如：网站、落地页、仪表盘、React 组件、HTML/CSS 布局，或对任意 Web UI 进行样式优化与视觉美化），请启用该能力。输出需为富有创意、精雕细琢的代码与 UI 设计，避免千篇一律的 AI 风格。

下载

<meta name="description" content="<?php echo esc_attr(meta_desc()); ?>">

✅ 补充建议：

立即学习“PHP免费学习笔记（深入）”；

• 使用 esc_attr() 对输出进行属性安全转义，防止 XSS 风险；
• 确保函数在 header.php 加载前已被 functions.php 定义（默认满足，因 functions.php 优先加载）；
• 可通过 var_dump(meta_desc()); die; 在函数末尾临时调试，确认返回值非空。

遵循以上规范，即可确保自定义函数在

区域稳定、安全、准确地输出预期内容。