本文详解为何不能直接在 functions.php 中插入 CSS 代码，以及如何通过正确的 PHP 钩子（show_admin_bar）安全、高效地为非管理员用户隐藏 WordPress 管理工具栏。
本文详解为何不能直接在 functions.php 中插入 css 代码，以及如何通过正确的 php 钩子（`show_admin_bar`）安全、高效地为非管理员用户隐藏 wordpress 管理工具栏。
你遇到的错误——syntax error, unexpected 'functions.php 是纯 PHP 文件，不支持直接嵌入 HTML 或 CSS 代码块。你粘贴的代码中包含 #wp-admin-bar-wp-logo{display: none;} 这类 CSS 规则，而 PHP 解析器将其误认为是未闭合的 PHP 标签（如 的开头
✅ 正确做法是：使用 WordPress 官方推荐的钩子机制控制管理工具栏（Admin Bar）的显示逻辑，而非尝试注入前端样式。
以下是一段稳定、可复用的解决方案：
/**
* 隐藏非管理员用户的 WordPress 管理工具栏
*/
function prefix_hide_admin_bar( $show ) {
// 仅对不具备 'administrator' 能力的已登录用户返回 false
if ( ! current_user_can( 'administrator' ) ) {
return false;
}
return $show;
}
add_filter( 'show_admin_bar', 'prefix_hide_admin_bar' );
? 将上述代码复制并粘贴到当前主题的 functions.php 文件末尾（确保位于 PHP 开标签
⚠️ 注意事项：
- 不要使用 is_user_logged_in() && !current_user_can('administrator') 双重判断——current_user_can() 在未登录时自动返回 false，因此该条件已隐含登录校验，更简洁安全；
- 避免使用 admin（错误能力名）或 manage_options（非等价于管理员角色）等模糊能力标识，应明确使用 'administrator'（角色名）或 'manage_network'（多站点超级管理员能力）；
- 若需为特定用户角色（如编辑、作者）保留工具栏，可改用 ! in_array( wp_get_current_user()->roles[0], ['administrator', 'editor'] ) 等逻辑扩展；
- 此方案服务端控制渲染，比前端 CSS 隐藏更彻底（避免闪屏、DOM 泄露、JS 绕过等风险）。
? 补充提示：若你确实需要定制工具栏中的某几项（如仅隐藏 Logo 和站点名称，但保留评论/新文章入口），应使用 admin_bar_menu 动作钩子移除节点，而非 CSS 隐藏——但这属于进阶需求，需额外注意节点 ID 变化与子菜单依赖关系。
总之，遵循 WordPress 的钩子规范，用逻辑控制代替样式覆盖，才能写出健壮、可维护的主题代码。
