跳到主要内容

不花钱，给技术博客做点简单的SEO

· 阅读需 5 分钟
季冠臣
季冠臣
后端研发工程师

作为开发者，我们都喜欢在博客上分享自己踩过的坑、总结出的经验。但很多时候，一篇自认为写得还不错的文章发出去后，除了朋友圈里的几个点赞，几乎无人问津。问题出在哪？内容不够好吗？不一定。更多时候，只是因为"需要它的人找不到它"。

这就是SEO（搜索引擎优化）要解决的问题。一提到SEO，很多人会联想到各种复杂的黑话和技巧，但对于我们技术博客来说，事情可以简单得多。它不是什么黑魔法，而是一系列逻辑清晰的、让搜索引擎（比如Google）更容易理解我们网站内容的步骤。

最近我给自己的博客做了点优化，效果还不错，这里就跟大家分享一下我做了哪些事。

技术层面：先让Google认识你​

这部分是基础，好在像Docusaurus这样的现代博客框架，已经帮我们做了大部分工作。我们只需要检查并确认几件事。

1. 网站地图 (sitemap.xml)​

这东西相当于你主动递给Google的一张网站"导览图"，上面列出了你所有的页面。有了它，Google就不会在你的网站里"迷路"，能更快、更全面地收录你的文章。

在Docusaurus里，你几乎不用管它，默认就是开启的。只要保证你的 docusaurus.config.js 里有正确的网站URL配置就行：

// docusaurus.config.js
const config = {
  url: 'https://jachen99.github.io', // 你的网站域名
  // ...
};

2. 元数据 (Meta Tags)​

元数据是藏在HTML <head> 标签里，专门给搜索引擎看的信息。最重要的有两个：

  • 全局关键词 (keywords): 用几个词概括你的整个博客是关于什么的。比如"Java, Spring, 后端, 技术博客"。
  • 页面描述 (description): 用一两句话总结当前页面的核心内容。

全局关键词可以在 docusaurus.config.js 里配置，一次搞定。而页面描述，我强烈建议为你认为重要的每一篇文章都手动加上。

内容层面：让你的文章"发光"​

技术搞定后，重头戏来了。这部分工作的核心思想只有一个：站在搜索者的角度思考。

1. 关键词：用户会搜什么？​

动笔前，想一个简单的问题："如果我遇到了这篇文章要解决的问题，我会在Google里输入什么？"

  • 要写JWT登出后失效？用户可能会搜："JWT 退出登录"、"jwt token blacklist"、"jwt 黑名单"。
  • 要写Nginx平滑重启？用户可能会搜："nginx reload"、"nginx 优雅重启"、"nginx -s reload 过程"。

想出这些词后，试着把它们自然地、不堆砌地安插在你的文章大标题和各个小标题 (##, ###) 里。这不仅能帮到SEO，也能让你的文章结构更清晰。

2. 那个重要的 description​

还记得上面说的页面描述吗？它至关重要，因为它很可能会直接显示在Google的搜索结果里，成为用户决定是否点击你网站的"门面"。

一篇没有description的文章，Google可能会随便从你文章里抓一段文字显示，效果通常不理想。

看看区别：

（优化前，Google可能抓取的样子）

...JWT是一种轻量级的身份验证方式。然而，一旦用户退出系统，之前的令牌理论上仍然是有效的，这可能导致一些...

（优化后，我们自己写的样子）

教程：如何解决JWT在用户登出后依然有效带来的安全风险。本文讲解通过Redis构建JWT黑名单，在用户退出时立即让令牌失效的双层安全机制...

哪个更吸引你点击？答案不言而喻。所以，在每篇重要文章的头部加上这个字段，花一分钟写好它。

---
title: "安全功能之系统退出后JWT令牌失效"
description: "教程：如何解决JWT在用户登出后依然有效带来的安全风险。本文讲解通过Redis构建JWT黑名单..."
---

3. 内部链接：把知识串成网​

在写新文章时，如果提到了一个你之前文章详细讲过的概念，别犹豫，给它一个链接指过去。

  • 比如，在写零拷贝时，提到了它是RocketMQ高性能的原因之一，就可以链接到你之前写的RocketMQ相关的文章。
  • 在讲JWT黑名单时，用到了Redis，就可以链接到你的Redis持久化文章。

这么做有两个好处：

  1. 方便读者深入学习，提升阅读体验。
  2. 帮助Google理解你网站内各个页面之间的关系，它会认为被链接越多的文章通常越重要，从而可能给予更高的权重。

总结​

你看，给技术博客做SEO，其实并没有那么复杂。总结一下就三件事：

  1. 想好关键词，并把它们用在标题里。
  2. 为重要文章写好description。
  3. 在文章间多做内部链接。

做这些事，不是为了取悦算法，而是为了更好地服务读者——那些和我们一样，在遇到问题时，打开Google寻找答案的开发者们。你把路修好了，他们自然就来了。

浏览量：加载中...