链接先看真实 href#

卡片点击跳转通常由文章 slug 或分类 slug 生成。迁移文章后，如果路径规则变了，最容易出现卡片显示正常但点击 404。

浏览器里可以右键复制链接，也可以直接检查 DOM 中的 href。确认它和构建出的页面路径一致。

标题和数量要完整#

分类卡片里最重要的是分类名称和文章数量。如果图标或装饰元素挤占空间，应该优先保证文字可读。标题可以适度换行，但不要只露出一个字或省略到无法识别。

检查顺序#

1. 数据层：分类数量是否来自真实文章统计。

2. 路由层：点击后是否进入对应分类或文章。

3. 视觉层：中文标题、长英文单词、数字是否溢出。

4. 响应式：手机宽度下卡片是否仍然可点击、可阅读。

常用验证#

1
curl -I https://blog.tjcheng.cn/categories/
2
curl -I https://blog.tjcheng.cn/posts/backfill/2026-06-23/nginx-404-403-check/

视觉问题最好再用浏览器看一遍，因为构建通过不能证明布局没有被挤坏。

实战复盘#

复盘《博客卡片链接检查方法》时，我会把它当成一个站点维护动作，而不是单篇文章。凡是影响首页、分类、RSS、Sitemap、搜索索引或旧链接的改动，都要在发布后做一次线上验证。

如果只在源码里看起来正确，但线上接口或页面没有变化，就说明构建或发布链路还有问题。博客维护类内容必须把“怎么确认已经生效”写清楚。

以后继续扩展这类文章时，可以补充真实命令输出、截图前后的差异，以及回滚路径。这样文章会更接近操作手册，而不是零散备忘。

最小验收样例#

验收《博客卡片链接检查方法》时，我会选一篇真实文章或一个真实页面作为样例，而不是只看源码。先确认页面能打开，再确认列表、分类、归档、搜索这些入口都能找到它。

如果文章讲的是站点维护，还要记录修改前后差异：改了哪个文件、构建产物是否更新、线上 HTTP 状态码是多少。这样后面出问题时，可以直接回到这次验收记录。

小结#

卡片检查要以读者能不能找到文章为中心。图标、阴影和动画都应该让位于清楚的标题、数量和可访问链接。