511遇见 网站主题文件及SEO优化完整记录清单

站点：https://www.511yj.com（另有 bbs.511yj.com） 环境：WordPress + 主题 aldehyde（2015 年深度改造版）+ PHP 8.3.33 + 阿里云 ECS 完成日期：2026-10-06 状态：第一阶段全部收尾，进入 2~8 周的搜索引擎观察期

一、紧急故障修复（直接影响收录）

二、主题模板修改

三、functions.php 修改

已扫描确认安全、无需修改的

只有 url 和 template_url 两个参数被 WordPress 废弃，name/description/charset 一直正常。

四、新增代码（追加在 functions.php 末尾）

兜底图目录

wp-content/uploads/default/ 放 3~5 张同尺寸图（建议 300×200），命名 1.jpg~5.jpg。 注意：img/ 是页脚二维码等专用图，pagephoto/ 是文章配图，都别混用。 仅当文章「无特色图 + 正文无图」时触发 —— 你每篇都设了特色图，所以基本用不上。

⚠️ 关于 nofollow 过滤器的版本选择

早期给的正则版 preg_replace_callback 会重写全文 HTML，在代码块、多行 <a>、属性值含 > 时可能破坏结构导致 CSS 失效。 推荐改用 WP 官方解析器版本（只改属性，不破坏字节）：

add_filter('the_content','web589_the_content_nofollow',999);
function web589_the_content_nofollow($content){
    if ( empty( $content ) || ! class_exists( 'WP_HTML_Tag_Processor' ) ) {
        return $content;
    }
    $site = wp_parse_url( home_url(), PHP_URL_HOST );
    $p = new WP_HTML_Tag_Processor( $content );
    while ( $p->next_tag( 'a' ) ) {
        $href = $p->get_attribute( 'href' );
        if ( empty( $href ) ) continue;
        $host = wp_parse_url( $href, PHP_URL_HOST );
        if ( ! $host || substr( $host, -strlen( $site ) ) === $site ) continue;
        $p->set_attribute( 'rel', 'nofollow noopener' );
        $p->set_attribute( 'target', '_blank' );
    }
    return $p->get_updated_html();
}

五、后台设置调整

WPJAM vs AIOSEO 元信息冲突（今日最实在的一处修复）

改之前：WPJAM 抢走了最重要的两个标签，你在 AIOSEO 里填的标题搜索引擎根本不用。

改完之后仍可优化的两处（可选，不影响排名）：

• og:site_name 还是「511遇见 | 不一样的遇见」→ 去「设置 → 常规 → 站点标题」改成 511遇见
• og:image 只有 130×50 → 社交分享时显示极小。建议做一张 1200×630 分享图，去 AIOSEO → 社交网络 → 默认社交图 设置

六、插件处置

✅ 已删除

⏸ 已停用，观察 3~5 天后删

✅ 必须保留

删除原则

先停用 → 观察 2~5 天 → 确认无异常 → 再删除。 停用 = 能随时启用回来；删除 = 设置和文件都没了。 别无限期留着停用插件 —— 文件还在硬盘上，仍可被直接通过网址访问。

七、排障要点备忘（重要，以后改站先看这里）

1. 首页 9 宫格是硬编码分类 ID

page-shouye.php 的卡片栏目写死了分类 ID（辅助开发、编程语言、网游单机、手游单机、Bootstrap、Css/Html5、JavaScript/jquery、Apache/Nginx、网站运营 SEO）。 动任何分类结构前，先确认首页、导航有没有引用它 —— 改一个分类会连锁反应好几个地方。

2. ⚠️ WPJAM「文章目录」会改坏正文 HTML

设置成 H6 + 显示在文章内容前面 时，它会扫描 H2~H6 并重写 the_content。 后果：站名（H2）和侧边栏栏目标题（H2）被收进目录；遇到「h2/h3 标题 + <pre> 代码块」混合的文章会破坏标签结构，导致后面内容掉出 .entry-content 容器，CSS 整段失效。

症状：新发的带代码块的文章，排版"有的地方有样式、有的没有"。

解决：关闭该扩展。需要时改用 显示层级 H3 + 使用 [toc] 插入内容中，只在文章里写了 [toc] 的地方生成目录。

3. 云锁会拦截含代码的文章保存

在编辑器粘贴含 HTML/SQL/PHP 的内容时，POST 数据会命中 XSS 规则（编号 201，IMG 标签类）被拦，导致内容只存进去一部分。 解决：云锁加 URL 路径例外，豁免这三个后台接口：

/wp-admin/post.php
/wp-admin/admin-ajax.php
/wp-admin/async-upload.php

4. 数据库备份要选对时间点

改分类这类会动数据库的操作前，单独导出相关表（wp_terms / wp_term_taxonomy / wp_term_relationships）最精准。 阿里云整机快照是最后兜底 —— 它会把文件系统层面的代码改动一起回滚，代价太大，别轻易用。

5. 其他

• 改主题文件后必须同步上传到阿里云 ECS —— 本地 xampp 改了，线上不会自动生效
• 改完先清 Redis + Cache Enabler，再用无痕窗口验证
• robots.txt 和 sitemap.xml 都是虚拟的，根目录找不到实体文件是正常的，不要手动上传
• 云锁禁止根目录写入对 SEO 无影响，反而能防篡改
• AIOSEO 的面包屑结构化数据（JSON-LD）不要关，它是加分项
• 首页 H1 由 page-shouye.php 的 sr-only 隐藏标题提供；文章页 H1 是文章标题；站名统一 <h2>，避免双 H1

八、推送相关

验证推送是否真正到达：百度搜索资源平台 → 资源提交 → 主动推送 → 看「已收录条数」（推送成功 ≠ 被收录）。

九、遗留待办（不影响运行）

十、常用验证命令（Windows CMD）

REM 先切 UTF-8，避免中文乱码
chcp 65001

REM 空 UA 是否 403
curl -s -o /dev/null -w "%{http_code}\n" -H "User-Agent:" https://www.511yj.com/

REM robots.txt
curl -s https://www.511yj.com/robots.txt

REM 站点地图归属（应显示 All in One SEO）
curl -s https://www.511yj.com/sitemap.xml | findstr /i "All in One"

REM 百度地图（必须 200，页脚在用）
curl -s -o /dev/null -w "%{http_code}\n" https://www.511yj.com/sitemap_baidu.xml

REM 首页 title（应显示 AIOSEO 版本）
curl -s https://www.511yj.com/ | findstr /i "<title>"

REM 首页是否还有 http 链接（无输出 = 通过）
curl -s https://www.511yj.com/ | findstr /i "http://www.511yj.com"

REM 分类旧链接是否 301
curl -s -o /dev/null -w "%{http_code}\n" https://www.511yj.com/category/front-end/

REM 附件页是否 301
curl -s -o /dev/null -w "%{http_code}\n" https://www.511yj.com/511yujian8

REM 文章里是否还有 /go?url=（无输出 = 通过）
curl -s https://www.511yj.com/sf-wydj-34.html > C:\t.html

REM 主题内查找短标签
cd C:\xampp\htdocs\wp-content\themes\aldehyde
findstr /s /i /n /c:"<? " *.php > C:\result.txt

REM 主题内查找废弃函数
findstr /s /i /n /c:"create_function" /c:"mysql_query" /c:"get_bloginfo" *.php > C:\result2.txt

CMD 输出中文乱码时，用 > C:\xxx.txt 存成文件再用记事本打开。 FINDSTR: 写入错误 是管道缓冲区被中文撑爆，不是站点问题。

十一、删除停用插件前的最终检查清单

跑一遍全过再删：

• [ ] 首页正常（9 宫格、轮播、Tab 都在）
• [ ] 分类页正常（/front-end/ 有文章、CSS 正常）
• [ ] 文章页正常（打开带代码块的那篇，排版完整）
• [ ] 侧边栏完整（搜索、最新文章、视频教程）
• [ ] 附件页 301
• [ ] sitemap.xml 归 AIOSEO
• [ ] sitemap_baidu.xml 返回 200
• [ ] 文章里搜不到 go?url

十二、本次优化成果总览

下一步：等待 2~8 周，观察 Bing / 百度站长后台的抓取量曲线。这段时间不要再做大的结构改动。

十三、后续修复与踩坑补充（2026-10-07 凌晨）

1. 服务器 ERR_TIMED_OUT 故障

现象：改完 main.css 上传后，浏览器报「www.511yj.com 响应时间太长」ERR_TIMED_OUT。

结论：与 CSS 无关。 CSS 是静态文件，最多样式错乱，不可能导致服务器不响应。实际是 PHP-FPM / Apache 重启后卡住。

排查顺序（以后照这个来）：

REM 1. 确认影响范围：本地 curl + 手机流量各测一次
curl -s -o /dev/null -w "%{http_code} 耗时:%{time_total}s\n" -m 15 https://www.511yj.com

REM 2. 服务器上看服务状态
systemctl status httpd
systemctl status php-fpm
systemctl status redis

REM 3. 检查配置语法（有错 Apache 会拒绝启动）
httpd -t

ERR_TIMED_OUT + "响应时间太长" = TCP 能连上但服务器不返回数据 —— 优先怀疑 PHP-FPM 卡死，不是服务器关机。 重启时先想清楚：本地 xampp 的 Apache 和线上 ECS 的 Apache 是两回事，重启本地对线上无任何影响。

2. 🔍 首页卡片 hover 放大效果消失 —— 根因是 Hover.css

现象：首页"图像印记"那 6 张卡片，鼠标移上去不再缓慢放大；分类页、文章页的图都还有效果。

根因（已查实）：主题集成了 Hover.css v2.0.1（Ian Lunn，MIT）。放大效果来自它的 .hvr-grow：

.hvr-grow{
  display:inline-block; vertical-align:middle;
  transform:translateZ(0);
  transition-duration:.3s; transition-property:transform;
}
.hvr-grow:active,.hvr-grow:focus,.hvr-grow:hover{
  transform:scale(1.1);
}

scale(1.1) + 0.3s 就是"慢慢变大、由远而近"的感觉。

首页失效的原因：page-shouye.php 的卡片 <a> 从来没挂过 hvr-grow，其他模板挂了。

这是主题 2015 年起就存在的模板不一致，不是本次优化改坏的。 排查中曾误判为 small、stxyj、img-thumbnail vs img-responsive，都排除 —— 教训见第 6 条。

修复（二选一）：

方案 A —— 给首页 <a> 加类（效果与全站完全一致）

<div class="col-xs-6 col-md-2 stxyj">
  <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"
     target="_blank" class="hvr-grow">
    <img class="img-thumbnail" src="..." alt="..." loading="lazy" decoding="async">
  </a>
  <p class="xiangguan-title">...</p>
</div>

⚠️ *别加在 `div.col-上** ——.hvr-grow自带display:inline-block，会破坏 Bootstrap 栅格浮动布局，6 列全乱。加在` 上最安全。

.stxyj a { overflow: hidden; }
.stxyj img {
    -webkit-transform: translateZ(0); transform: translateZ(0);
    -webkit-transition-duration: .3s; transition-duration: .3s;
    -webkit-transition-property: transform; transition-property: transform;
}
.stxyj:hover img {
    -webkit-transform: scale(1.1); transform: scale(1.1);
}

. stxyj p{         ← 点和 stxyj 之间有空格
   background:#eee; line-height:23px;
   color:#999999; margin-bottom:50px;
}

.stxyj img{width:100%;overflow:hidden;}

<time class="small pull-right">...</time>

.xiangguan-title{
   padding-top:5px;
   height: 23px;        ← 容器 23
   line-height: 33px;   ← 行高 33
   color:#999999; overflow:hidden;
}

.xiangguan-title{ padding-top:5px; height:33px; line-height:33px; color:#999999; overflow:hidden; }

REM ① 全局搜关键词，看哪些文件引用了它
cd C:\xampp\htdocs\wp-content\themes\aldehyde
findstr /s /i /n /c:"hvr-grow" *.php > C:\hvr.txt

REM ② 备份文件与线上文件对比（最快确认"是不是我改丢的"）
fc C:\备份路径\main.css C:\xampp\htdocs\wp-content\themes\aldehyde\main.css

REM ③ 让浏览器直接告诉你（最准）
REM    F12 → 选中元素 → 右侧 Styles 面板 → 点 :hov → 勾 :hover
REM    新出现的规则就是答案，面板会显示"哪个文件第几行"