WordPress登录页面自定义logo不显示问题排查求助

首先明确：不需要把代码放到父主题的functions.php里，子主题的functions.php是正确的存放位置，你的代码逻辑本身没问题，不生效大概率是以下几个原因导致的：

可能的问题及解决方法 #

• 图片路径无效：直接在浏览器打开https://www.example.org/logo.png，确认图片能正常加载。如果图片放在子主题的images文件夹里，建议用WordPress内置函数获取路径，避免硬编码出错：

  background-image: url('<?php echo get_stylesheet_directory_uri(); ?>/images/logo.png');
  

• CSS优先级不足：默认WordPress登录样式可能覆盖了你的自定义代码，可以给样式属性加上!important强制生效（登录页场景下使用不会有副作用）：

  #login h1 a, .login h1 a {
      background-image: url('你的图片地址') !important;
      height: 65px;
      width: 320px;
      background-size: auto;
      background-position: center center;
      background-repeat: no-repeat;
      padding-bottom: 30px;
   }
  

• 缓存干扰：浏览器缓存或WordPress缓存插件（如WP Rocket、W3 Total Cache）会保留旧样式，按Ctrl+F5强制刷新浏览器，或清空缓存插件的缓存。
• 钩子执行时机问题：虽然login_enqueue_scripts是正确钩子，但可以尝试换成login_head钩子，确保样式能输出到登录页头部：

  function add_custom_logo(){
  ?>
   <style type="text/css">
     #login h1 a, .login h1 a {
         background-image: url('你的图片地址');
         height: 65px;
         width: 320px;
         background-size: auto;
         background-position: center center;
         background-repeat: no-repeat;
         padding-bottom: 30px;
      }
   </style>
  <?php
  }
  add_action('login_head', 'add_custom_logo');
  

更标准的实现方式 #

除了修改样式，还可以同时修改Logo的跳转链接和提示文字，让功能更完整：

// 修改登录Logo跳转链接为网站首页
function custom_login_logo_url() {
    return home_url();
}
add_filter('login_headerurl', 'custom_login_logo_url');

// 修改登录Logo的提示文字为网站名称
function custom_login_logo_url_title() {
    return get_bloginfo('name');
}
add_filter('login_headertext', 'custom_login_logo_url_title');

// 添加自定义登录样式
function custom_login_styles() {
    ?>
    <style type="text/css">
        #login h1 a, .login h1 a {
            background-image: url('<?php echo get_stylesheet_directory_uri(); ?>/images/logo.png');
            height: 65px;
            width: 320px;
            background-size: contain;
            background-position: center center;
            background-repeat: no-repeat;
            padding-bottom: 30px;
        }
    </style>
    <?php
}
add_action('login_enqueue_scripts', 'custom_login_styles');

内容的提问来源于stack exchange，提问作者newbiedev