本文详解为何不能直接在 functions.php 中写 css 代码，以及如何通过正确的 php 钩子（show_admin_bar 过滤器）安全、高效地为非管理员用户完全隐藏后台工具栏。
本文详解为何不能直接在 functions.php 中写 css 代码，以及如何通过正确的 php 钩子（show_admin_bar 过滤器）安全、高效地为非管理员用户完全隐藏后台工具栏。
你在 functions.php 中尝试插入类似
✅ 正确做法是：使用 WordPress 官方推荐的 show_admin_bar 过滤器，在 PHP 层控制工具栏是否渲染，既安全又高效：
// 在主题 functions.php 文件末尾添加（确保在 <?php 开标签内，且不在其他函数内部）
function prefix_hide_admin_bar( $show ) {
// 仅对非管理员用户返回 false，彻底禁用工具栏渲染
if ( ! current_user_can( 'administrator' ) ) {
return false;
}
return $show;
}
add_filter( 'show_admin_bar', 'prefix_hide_admin_bar' );? 关键说明：
- current_user_can('administrator') 比 !is_user_logged_in() && ... 更精准：它严格校验用户角色能力，而非仅依赖登录状态；
- 返回 false 会阻止工具栏 HTML 和相关 JS/CSS 的任何输出，比前端 CSS 隐藏更彻底（无资源加载、无 DOM 节点、无潜在样式冲突）；
- 函数名 prefix_hide_admin_bar 中的 prefix 建议替换为你的主题缩写（如 mytheme_hide_admin_bar），避免与其他插件/主题函数冲突；
- 该过滤器在 WordPress 初始化早期执行，性能开销极低，且兼容所有现代 WordPress 版本（5.0+）。
⚠️ 注意事项：
- 不要将 CSS 选择器（如 #wp-admin-bar-site-name）直接写入 functions.php；若需定制化显示（如仅隐藏某几项但保留工具栏），应使用 admin_bar_menu 动作钩子动态移除节点，而非 CSS；
- 修改前请备份 functions.php，并确保服务器启用了 PHP 错误提示以便快速定位语法问题；
- 若你使用的是子主题，请务必在子主题的 functions.php 中添加代码，避免父主题更新时丢失修改。
总结：WordPress 的扩展机制建立在“钩子（Hooks）”之上，而非硬编码样式。善用 show_admin_bar 过滤器，不仅解决当前需求，更符合主题开发最佳实践——语义清晰、维护性强、零兼容性风险。
